统计需要来源信息，不需要整条敏感链接
统计需要保留来源信息，但不应无差别收集所有查询参数。 营销参数能够帮助判断访客从哪里来，但查询串中也可能出现临时令牌、邮箱或内部标识。采用允许列表，比尝试穷举所有敏感参数更容易控制范围。
继续阅读恰西 / 按主题阅读
技术笔记
访问量为什么和 Nginx 请求数差那么多？
一张页面会加载多项资源，机器人也会不断访问路径，服务器请求数自然不等于浏览量。浏览器脚本更接近页面行为，但又会漏掉被拦截或禁用脚本的访问。
继续阅读发布前扫一遍链接，能挡住不少低级错误
发布前扫描本地链接与资源，可以提前发现遗漏文件和错误路径。
继续阅读图片优化从“显示多大”开始
把超大原图直接缩到一个小卡片中，会消耗不必要的流量；尺寸属性缺失还可能在加载后推动布局变化。正确准备展示尺寸，往往比只调压缩质量更有效。
继续阅读页面没链接到草稿，不代表它没有泄露
静态搜索通常通过 JSON 索引实现，索引本身也是公开产物。 静态站的公开产物不仅包括 HTML，还可能包括 JSON 搜索索引、RSS、站点地图和附件。正文未显示在列表里，却被写进索引，同样可以被任何人获取。
继续阅读RSS 订阅最怕什么？旧文章不断变成新文章
订阅器通常依赖稳定标识判断条目是否已读。迁移站点时，即便正文完全一样，随意更换 guid 或文章地址，也可能让订阅者重复收到旧内容。
继续阅读sitemap 不是一张“保证收录”的清单
站点地图帮助发现页面，但不能替代页面质量与可访问性。
继续阅读永久链接一旦公开，就值得认真维护
文章移动目录、修改标题或替换生成工具，都不应该轻易让旧链接失效。把 URL 作为独立配置管理，可以让内容维护与公开地址保持相对稳定。
继续阅读文章日期，要在元数据里统一定义
标题、日期和草稿状态应放在明确的元数据字段中，避免仅修改正文显示。 列表、正文、RSS 和站点地图可能读取不同时间字段。只修改页面上显示的一行文字，很容易让其他入口仍保留旧日期，出现看起来互相矛盾的记录。
继续阅读静态网站，也可以有持续更新的数据
静态指访问时提供已经生成的文件，并不要求数据永远不变。外部接口可以在构建前采集，再把结果写入快照，访问者仍然只需要请求静态页面。
继续阅读一份有用的网络排障记录，至少要记什么
地点、时间、地址族和是否走代理都会影响结果，需要写进记录。
继续阅读远程回家之前，先决定谁能进哪些门
隧道解决连接到达问题，VPN 提供网络访问能力，但两者都需要明确身份与授权。把整个内网默认开放给每个客户端，往往超出实际远程访问需求。
继续阅读清了浏览器缓存，为什么解析还是旧的？
浏览器、操作系统和路由器都可能缓存结果，清理某一层不一定清理其他层。 缓存分布在不同层：浏览器、操作系统、路由器和上游递归服务可能各自保存结果。修改某一层并不会自动通知其他层，因此排查需要观察具体边界。
继续阅读监听在 0.0.0.0 和 127.0.0.1，有多大差别
前者通常表示所有本机 IPv4 接口，后者只允许通过回环接口连接。应用配置正确与入口范围合适需要同时满足，尤其是数据库或管理后台。
继续阅读小包能通，大页面却卡住：再看看 MTU
小包能通不代表路径能正确传递更大数据，分片和路径 MTU 发现需要正常工作。
继续阅读关掉 IPv6 就好了，原因可能不止一种
双栈客户端可能优先使用 IPv6，但两种地址族的路由和代理规则可以完全不同。IPv4 被接管而 IPv6 直接出站，或者 LAN 缺少有效前缀，都会呈现类似症状。
继续阅读WAN 有 IPv6，LAN 就一定能用吗？
路由器自身拿到 IPv6 地址，不代表 LAN 已获得可用的子网前缀。 路由器自身的地址与向下游分配的前缀属于不同配置内容。客户端还需要有效地址、默认路由、DNS 以及允许转发的防火墙规则，任何一环缺失都可能失败。
继续阅读DDNS 有记录，为什么家里服务仍连不上？
域名只负责把名称映射到地址。运营商地址转换、家庭防火墙和服务监听都决定连接能否到达，DDNS 不会自动建立缺少的入站路由。
继续阅读一条 DNS 请求，在路由器里转圈了
本机 DNS 被代理服务接管后，再把上游指回同一入口会让请求反复转发。
继续阅读新增解析后仍说不存在，可能是负缓存
DNS 不仅缓存成功记录，也可能暂存不存在的回答。新增记录已经正确写入权威区后，之前查询过的解析器仍可能沿用旧的否定结果。
继续阅读改了域名记录，应该先问哪台 DNS？
递归服务器代用户查找答案，权威服务器提供某个区域的数据。 权威服务器决定区域中的记录，递归服务器通常缓存并代为查询。两者都能回答同一个域名，但回答的来源和刷新时机不同，排错时需要有意区分。
继续阅读浏览器说网络错误，先从 DNS 分层看
域名解析失败时，连接阶段可能根本没有开始；解析成功后仍可能遇到目标端口或 TLS 问题。按阶段排查能避免反复更换节点却忽略真正的故障点。
继续阅读构建成功与发布成功之间，还隔着几道门
构建只证明产物生成，部署路径、证书和代理仍可能有问题。
继续阅读让告警直接指向下一步动作
只发一句“服务异常”会把定位工作全部留给接收者。告警应让人知道哪个服务、什么症状、持续多久，并能直接进入相关日志或监控页面。
继续阅读线上到底是哪一版，应该能查出来
线上问题需要对应到源码、配置和产物，而不只是一个模糊的发布时间。 仅知道“下午发布过”不足以定位问题。代码摘要、构建编号和产物标识形成关联后，才能判断配置、页面与日志是否来自同一轮部署。
继续阅读发布文件时，避免让读者看到半截内容
直接向正式文件写入的过程中，其他进程可能同时读取。先在同一文件系统准备完整文件，再切换入口，可以把长时间写入缩成一个较短的可见变化。
继续阅读任务超时之后，能不能直接再跑一次？
同一输入重复执行时，任务应尽量得到一致结果，避免重复插入或重复通知。
继续阅读终端能跑，定时任务却失败
交互式 Shell 常常加载额外的 PATH、别名和环境变量，计划任务通常没有相同条件。相对路径、默认解释器和未传入的凭据，都可能成为差异来源。
继续阅读同一条 cron，换台服务器就晚了八小时
同一条 cron 在不同时区的主机上会对应不同本地时刻。 cron 的时间表达式需要放在具体时区中解释。服务器、容器和云端调度平台不一定使用相同时区，夏令时地区还可能出现日期边界变化。
继续阅读磁盘还有空间，也可能写不进文件
目录中的每个文件都需要元数据资源。大量小文件可能先耗尽 inode，而少数大文件则更容易耗尽数据空间，两种问题的处理方式并不相同。
继续阅读平均响应 100 毫秒，为什么还有人等很久？
平均耗时容易掩盖少数很慢的请求，分位数能描述尾部体验。
继续阅读CPU 很闲，用户却说网站打不开
资源指标描述机器内部状态，外部请求才能覆盖域名、证书、代理与应用链路。两类信息结合起来，才能区分主机压力、网络故障和业务逻辑错误。
继续阅读日志已经改名，磁盘为什么还在涨？
改名后的日志可能仍被进程持有，轮转策略应考虑重新打开文件。 进程打开文件后持有文件描述符，路径改名或删除不一定会让它立即换到新日志。轮转既涉及文件操作，也涉及通知进程重新打开目标文件。
继续阅读一份没恢复过的备份，有多少把握？
压缩包能打开只是最基础的完整性信号。数据库结构、数据版本与恢复权限都可能影响真正使用，因此备份流程应该包含一次独立环境中的恢复演练。
继续阅读Docker 占了很多空间，先分清是哪一种
镜像、构建缓存、日志和卷的用途不同，应按对象确认占用。
继续阅读更新前保留旧镜像，为什么仍然回不去？
程序升级可能同时修改数据库结构和持久文件格式。旧镜像能启动，不代表它仍能理解新数据，因此应用版本与数据版本需要作为一个整体考虑。
继续阅读容器里的 127.0.0.1 到底指向谁？
容器内部的 localhost 指向它自己，不会自动指向另一个数据库容器。 每个容器通常拥有独立网络命名空间。应用连接 localhost 时，寻找的是自己内部的服务，而不是宿主或旁边的数据库容器，这是容器迁移时常见的误解。
继续阅读小服务器分配内存，不能只看现在用了多少
当前占用只是某个时刻的样本，启动、迁移和流量高峰可能需要更多内存。设置上限能约束影响范围，但也可能把原本可用的服务限制到无法完成启动。
继续阅读一直在重启，并不叫自动恢复成功
自动重启有助于进程退出后的恢复，但反复崩溃需要查明根因。
继续阅读排容器故障，先截取有用的那段日志
完整日志可能很长，近期几十行通常更接近本次启动问题。配合故障时间与容器重启记录，可以区分启动失败、运行异常和旧问题残留。
继续阅读Up 和 Healthy，说的是不同层次的事
进程存在与业务接口能够响应是不同状态，健康检查要覆盖最小可用路径。 容器 Up 说明入口进程仍在运行，Healthy 则取决于配置的探测命令。应用卡死、依赖不可达或内部错误时，进程可能没有退出，业务却已经不可用。
继续阅读Compose 校验通过，只是上线前的第一关
配置展开能够发现一部分语法和变量问题，但它并不连接数据库，也不验证业务接口。将部署声明保存下来，有助于比较变更，同时不能省掉运行检查。
继续阅读持久卷解决的是生命周期，不是备份
数据库目录需要持久化，否则重新创建容器可能失去历史数据。
继续阅读只给 Nginx 用的端口，不必开放给全网
发布端口时省略宿主地址，可能把应用绑定到所有接口。若公网流量统一经过 Nginx，绑定回环可以减少绕开入口代理直接访问应用的路径。
继续阅读镜像版本固定了，还要不要记录摘要？
固定版本便于复现，摘要还能进一步明确具体镜像内容。 标签便于人理解版本，但仓库中的标签可能被重新指向其他内容。摘要对应具体清单，更适合记录一次部署实际使用的镜像，便于后续审计和复现。
继续阅读镜像还在，为什么容器里的数据没了？
同一个镜像可以创建多个容器，每个容器的可写层彼此独立。重新创建容器不会自动继承另一个容器临时写入的内容，因此镜像不能被当作运行数据的保存位置。
继续阅读公开接口和管理接口，最好有明确分界
代理入口应区分公开采集接口与需要登录的管理接口。
继续阅读换好证书之后，再从公网看一次
证书文件可能已经替换，但旧进程、另一层代理或错误的虚拟主机仍然提供旧证书。磁盘检查与公网握手检查对应不同层次，缺一项都可能漏掉问题。
继续阅读上传失败，限制可能不在应用里
客户端、代理和应用都可能限制请求大小，错误应定位到具体一层。 请求从客户端到应用可能经过多个代理，每一层都能设置大小限制。返回 413 时应先识别由谁生成响应，再决定修改哪一处配置。
继续阅读开启 gzip 之前，先确定压缩对象
文本往往包含重复结构，压缩收益较明显；JPEG、视频等格式本身已压缩，重复处理未必值得。还要考虑 CPU 成本和代理缓存如何区分响应版本。
继续阅读访问日志里的 404，哪些值得处理？
按状态和请求路径观察，可以区分丢失资源、爬虫扫描和上游故障。
继续阅读CSS 更新后没变化，先看看缓存头
相同 URL 在缓存期内可能直接使用旧内容。入口页面与带指纹资源通常需要不同策略，资源版本写进文件名，可以让更新更加明确而可预测。
继续阅读代理的“等多久”，至少有两个答案
连接上游与等待上游返回是两个阶段，分别设置才能准确排障。 连接超时处理的是无法与上游建立连接；读取超时处理的是连接已存在但迟迟没有新数据。两者适合不同故障，统一加大数值常常只会延长用户等待。
继续阅读反代报错时，先绕开代理查上游
从本机回环地址访问应用，能够快速区分应用没有启动、端口不对和代理配置错误。随后逐层加回域名、TLS 与转发头，更容易定位第一个失败边界。
继续阅读try_files：文件不存在，就明确告诉客户端
静态网站可以先检查文件和目录，缺失时明确返回 404。
继续阅读一次平滑重载，背后发生了什么
重载让主进程读取新配置并启动新 worker，旧连接通常交由旧 worker 收尾。 主进程读取新配置并启动新 worker，旧 worker 尽量完成已经接收的工作。相比直接停掉服务，这通常能减少普通配置变更对现有连接的影响。
继续阅读先 nginx -t，再让配置生效
检查命令解析指定配置，能发现部分语法、文件路径与资源访问问题。运行中的实例可能使用另一套路径，检查目标与实际服务必须一致才有价值。
继续阅读同一时刻，为什么能显示成两个日期？
统一保存明确的时间点，再按用户时区展示，可减少跨地域歧义。
继续阅读把界面偏好交给 localStorage，需要哪些兜底？
它提供同源的字符串键值存储，适合主题和语言等偏好。用户清理数据、存储受限或浏览模式变化时，这些值都可能不存在，代码需要合理缺省行为。
继续阅读搜索框防抖之后，还要处理旧响应
输入连续发生时延后处理，可以减少搜索或布局计算次数。 防抖减少的是请求触发次数，不会自动取消已经发出的请求。较早发出的慢请求可能较晚返回，把较新的搜索结果覆盖掉，形成另一种竞态。
继续阅读展示一段文字，没必要把它交给 HTML 解析器
用户输入可能恰好包含尖括号，也可能包含有意构造的标记。textContent 会把输入作为文本处理，避免展示需求无意变成执行页面结构的能力。
继续阅读查询字符串里，一个参数可以出现两次
查询字符串不是简单的键值拼接，重复参数和转义字符都应明确处理。
继续阅读await 让代码像同步，但执行仍然异步
await 让异步代码更易读，但函数调用者仍然需要处理异步结果。 async 函数把返回值包装为 Promise，遇到 await 时把后续执行交还给异步调度。它改变的是表达方式，并不会让耗时操作失去延迟或失败的可能。
继续阅读异步链条里的错误，需要有人接住
then 中返回的值决定下一步接收什么，而抛出的错误会进入拒绝路径。如果在错误处理中只打印日志然后正常返回，后续阶段可能继续按成功结果执行。
继续阅读列表后来才生成，点击事件也能接住
把监听器放在稳定父节点上，可以处理后来加入的子元素。
继续阅读筛选和转换，拆开之后更容易检查
filter 的回调决定是否保留，map 的回调决定输出值。拆成清晰阶段后，可以分别观察每一步的输入和输出，更容易定位条件错误或类型变化。
继续阅读两个看起来一样的值，为什么不相等？
类型转换可能让条件判断产生意外结果，严格相等更便于推理。 严格相等避免一部分隐式转换，但对象比较的是身份。两次创建的对象即使字段相同，也不会因为外观一致就成为同一个引用。
继续阅读const 不变，对象为什么还能修改？
变量保存的是对对象的引用。const 限制重新绑定变量，并没有递归冻结引用指向的内容，因此修改属性与把变量换成另一个对象属于不同操作。
继续阅读SQLite 备份不只是复制一个文件
成功复制文件并不等于备份可恢复，数据库写入过程中尤其如此。
继续阅读按月统计之前，先统一时间含义
字符串格式统一只是起点，业务上的月份还依赖时区。一个 UTC 时刻换算到当地时间后可能进入下个月，因此报表需要明确使用哪个时间边界。
继续阅读分页的第一步，是确定什么叫“下一页”
分页需要稳定的排序规则，否则相邻页可能重叠或遗漏。 数据持续变化时，按偏移量切片可能在两次请求之间产生重复或遗漏。即使静态数据也需要明确排序，否则数据库没有义务按固定顺序返回行。
继续阅读LEFT JOIN 后记录少了，问题可能在 WHERE
左连接先保留左侧记录，并用空值补齐没有匹配的右侧字段。若随后要求右表字段满足某个普通条件，这些空值记录又会在 WHERE 阶段被排除。
继续阅读查询计划是一张路线图，不是秒表
SQLite 查询计划能展示扫描和索引访问，适合作为优化前后的对照。
继续阅读加索引之前，先看查询怎么找数据
索引更像辅助查找结构，不是所有查询的加速按钮。过滤条件、排序方式和数据分布都会影响收益，维护索引也会增加插入与更新成本。
继续阅读唯一性不能只靠插入前查一下
先查询再插入仍可能遭遇并发竞争，唯一性必须由约束保证。 两个并发请求都可能看到“目前不存在”，随后各自插入。数据库约束在写入时做最终判断，才有机会阻止竞争条件造成的重复记录。
继续阅读一半成功的操作，交给事务处理
两项相关修改若分开提交，中间失败就可能留下不一致状态。事务把数据库内的工作组合成一个提交单元，调用方可以根据完整结果决定提交还是回退。
继续阅读SQL 参数绑定，到底替你解决了什么？
参数绑定负责区分代码与数据，字符串拼接不能提供同等保障。
继续阅读报表数量对不上，检查 COUNT 的对象
一列允许 NULL 时，已存在的记录不一定拥有该列的值。统计记录总量和统计已填写某字段的数量，应使用不同表达式，才能让业务口径与结果一致。
继续阅读分组查询的条件应该放在哪一层？
WHERE 过滤原始记录，HAVING 过滤分组后的聚合结果。 查询可以先从原始行里排除不符合条件的数据，再对剩余数据分组，最后筛选聚合结果。理解这两个过滤阶段，比死记 WHERE 和 HAVING 的名字更有效。
继续阅读查数据时，先别 SELECT 星号
探索表结构与生成业务结果有不同目标。显式列出需要的字段，既减少无用传输，也让调用方不容易受到新增列或列顺序变化的影响。
继续阅读命令行脚本也需要一个清楚的接口
命令行入口应对参数类型与缺省值给出明确约束。
继续阅读依赖隔离，比“我这台机器能跑”更可靠
系统里多个项目共享同一套包时，一个升级可能改变另一个项目的行为。虚拟环境为项目提供独立安装位置，但仍依赖所选基础解释器与操作系统库。
继续阅读小函数也值得测一测空输入
稳定的测试不仅覆盖正常结果，也应检查空输入和边界值。 只测试常见输入容易留下边界盲点。空列表、缺失字段和重复元素往往不复杂，却能暴露对数据形状的错误假设，使后续重构更有把握。
继续阅读日志要让故障能被重现，而不是只留下“失败”
一条有用的日志通常包含操作对象、阶段和失败原因。等级帮助筛选严重程度，统一的格式帮助关联同一次任务，比在各处随意打印更适合长期维护。
继续阅读生成器节约内存的代价是什么？
生成器按需产生值，适合不必一次放进内存的处理流程。
继续阅读字典里没有这个键，和它的值为空不同
配置合并、接口响应和可选字段经常需要区分这两种状态。get 返回 None 时，单凭结果无法知道是键缺失还是显式设置为空，因此条件设计要先确定语义。
继续阅读列表推导式：短一点，也要读得懂
推导式适合筛选和映射，逻辑复杂时显式循环更容易阅读。 简单筛选后再转换，是列表推导式最合适的场景。它会立即构建完整列表；当输入很大或后续只消费少数元素时，内存开销也需要纳入选择。
继续阅读异常处理，别把真正的问题藏起来
捕获异常的目的是在当前层采取有意义的恢复措施。转换失败可以给用户输入提示，文件缺失可以说明路径；一律返回空值却会让错误在更远处才爆发。
继续阅读JSON 里的中文被转义，不一定是乱码
JSON 是数据交换格式，输出可读性与字符串内部值是两回事。
继续阅读路径拼接里，少一点字符串技巧
手工拼接斜杠需要同时考虑绝对路径、分隔符和平台差异。Path 对象让路径组合与文本格式化分开，也更容易继续执行存在性检查或目录遍历。
继续阅读文件写完了，为什么还要关心关闭时机？
上下文管理器可以在正常结束和异常退出时释放文件资源。 文件对象可能持有缓冲数据和系统资源。with 把资源生命周期限制在代码块里，异常发生时也会调用退出清理，通常比手工在多个分支 close 更清楚。
继续阅读中文文件换台机器就乱码，先查默认编码
文件在磁盘上只是字节，读取时才按指定编码变成字符串。同一段代码依赖平台默认值，容易在开发机正常、计划任务或另一台服务器上失败。
继续阅读错误页面很好看，也应该返回 404
错误页可以友好展示，但响应状态仍应表达资源不存在。
继续阅读查询参数不要靠手工拼接
空格、中文和 & 等字符在 URL 中拥有特定含义。参数值未经编码就拼入字符串，可能变成新的参数，甚至让服务端接收到与用户输入不同的值。
继续阅读页面慢在解析、建连，还是等待正文？
DNS、建连、TLS 和等待响应是不同阶段，分阶段计时更容易定位瓶颈。 把总耗时拆开，能避免把 DNS 慢、TLS 慢和应用处理慢都归因于服务器性能。curl 的时间字段多为自请求开始累计的值，解释阶段时要注意差值关系。
继续阅读代理之后，日志里的 IP 为什么全一样？
应用只能直接看到与它建连的那个代理地址。转发头可以携带原始来源，但这项信息必须由可信代理建立，应用也只能信任已定义的代理链。
继续阅读HTTPS 握手成功，还不算证书检查完成
证书受信任和域名匹配需要同时成立，有效期也应在检查范围内。
继续阅读跨域报错，到底是谁拒绝了谁？
服务器可能已经处理请求，但浏览器不允许页面脚本读取响应。简单请求与预检请求的流程也不相同，因此控制台报错不能直接等同于接口未被调用。
继续阅读Cookie 只是载体，会话还需要生命周期
会话通常通过随机标识关联服务端状态，Cookie 只是传递标识的一种机制。 浏览器保存一个标识并不等于完成会话管理。服务端仍需要定义会话有效期、退出失效和权限检查；Cookie 属性主要限制传输与脚本访问方式。
继续阅读304 没有正文，为什么页面还能显示？
客户端已经保存了一份资源，条件请求只是询问这份版本是否仍可使用。服务器返回未修改后，浏览器继续使用本地正文，减少了重复传输。
继续阅读缓存策略要跟着内容生命周期走
静态资源和登录后的个性化页面不应共用相同缓存设置。
继续阅读扩展名没错，浏览器为什么仍不认？
客户端接收的是一段响应数据，如何解释主要依赖媒体类型，而不是服务器磁盘上的名字。脚本被返回为错误页或文本时，浏览器可能拒绝执行。
继续阅读网站搬家后，301 应该指向哪里
永久迁移与临时跳转应使用不同语义，避免客户端长期缓存错误目标。 迁移的目标是让旧地址继续对应原有内容，而不是把流量一律送回首页。保留路径关系和明确跳转语义，能让用户、缓存与搜索引擎得到一致信号。
继续阅读看到 500 之前，先弄清是谁返回的
状态码是入口，响应头、正文特征和日志时间才帮助确认返回者。CDN、反向代理和应用都可能返回错误，处理位置不同，解决办法也完全不同。
继续阅读分支指针走错了，reflog 还能提供线索
分支移动和切换会留下本地引用日志，可用于定位误操作前的位置。
继续阅读blame 的价值在上下文，不在找人背锅
某一行最后被修改，可能只是因为格式化、移动文件或重命名变量。真正理解设计原因，需要继续查看对应提交、相关文件和当时的约束条件。
继续阅读发布版本需要一个稳定的名字
标签提供稳定的版本引用，便于将线上产物对应到具体源码。 分支随着新提交持续移动，标签更适合表示某个发布节点。带注释标签还能保存发布说明，但线上最终运行的产物仍需要与提交摘要建立对应关系。
继续阅读stash 不是一个随手塞东西的黑盒
临时保存有助于切换上下文，但多份 stash 缺少描述时，很快就难以判断哪份对应哪个任务。保存前检查范围，恢复前查看差异，可以减少覆盖冲突。
继续阅读写进 .gitignore，为什么 Git 还在跟踪？
忽略规则主要影响未跟踪文件，不会自动解除已有文件的跟踪。
继续阅读一条提交说明，不能代替补丁
说明表达修改意图，补丁才展示实际变化。对比文件范围、上下文和代码内容，可以发现顺手带入的配置改动，或者看起来很小却影响多个入口的修改。
继续阅读先 fetch，再决定怎么接收远端修改
fetch 更新远端跟踪信息，pull 还会继续执行集成操作。 把获取远端状态和集成本地代码分开，可以留出检查差异的机会。fetch 本身不把远端提交直接合入当前分支，更适合先了解发生了什么。
继续阅读切任务之前，先确认自己在哪条分支
工作目录看起来没有变化，不代表 HEAD 仍指向之前的分支。先确认当前引用，可以避免把临时实验提交到主线，也方便选择正确的比较基准。
继续阅读提交历史不只是按时间排的一列文字
提交图能够显示分支关系，单看时间排序容易误解合并顺序。
继续阅读提交前只看 git diff，可能漏了一半
普通 diff 查看未暂存变更，cached diff 查看准备进入提交的内容。 暂存区是提交内容的直接来源，普通 diff 却默认比较工作区与暂存区。文件一旦暂存，相关修改可能从普通 diff 中消失，但仍会进入下一次提交。
继续阅读Git 的两列状态，其实在说两件事
短状态输出的两列分别描述暂存区与工作区状态。一个文件可能已经暂存一部分修改，随后又被继续编辑，因此它同时出现在两个位置并不矛盾。
继续阅读脚本先过语法关，再谈运行结果
语法检查可以提前发现括号或引号不配对，但不会证明业务逻辑正确。
继续阅读不要把 ls 的展示结果当成文件列表接口
给人阅读的输出可能受到列宽、颜色、转义和语言环境影响。文件名又允许空格与换行，把文本再按空白切开，会丢掉原本的路径边界。
继续阅读让短选项解析回归 getopts
手写位置参数判断容易漏掉组合选项，getopts 适合短选项接口。 参数数量变多后，手写 shift 与位置判断容易漏掉选项取值、未知字符和错误状态。getopts 提供基础解析循环，让脚本能把注意力放回实际业务。
继续阅读固定的 /tmp 文件名为什么不可靠
两个任务使用相同临时路径时，可能互相覆盖，也可能读到另一轮任务的残留。mktemp 创建的独立目录使输入、中间结果与输出更容易保持一一对应。
继续阅读临时文件的善后交给 trap
临时资源需要在成功和失败两条路径上都能释放。
继续阅读Shell 函数的参数边界要明确
函数把重复步骤集中起来，但如果内部偷偷读取和修改全局变量，调用者仍然很难预测结果。先明确参数、标准输出与退出码，封装才真正具有价值。
继续阅读几个固定选项，用 case 比嵌套 if 清楚
固定选项可以通过 case 表达，比分散的条件判断更容易检查。 启动、停止、帮助这类有限集合，可以把每个选项的行为放在一个相邻分支中。这样既方便审查支持范围，也容易发现默认路径是否遗漏了输入。
继续阅读2>&1 放在哪里，结果为什么不同
重定向表达式按照书写顺序处理。把标准错误连接到标准输出时，连接的是那个时刻的目标；之后再改变标准输出的去处，并不一定改变先前建立的关系。
继续阅读结果与诊断信息应该走不同通道
正常结果适合供下游解析，诊断信息应写到标准错误。
继续阅读别通过“有没有输出”判断执行成功
有些命令成功时保持安静，有些失败时依然会输出部分结果。退出码提供了另一条独立信号，调用方应该先根据状态选择分支，再决定如何展示信息。
继续阅读逐行读文件时，别吃掉反斜杠和空格
反斜杠可能被 read 解释，使用 -r 可以避免它作为转义符被消费。 文本行常常包含路径、正则表达式或缩进，读取时不应未经约定就把它们重新解释。清空 IFS 与启用 read -r，分别处理首尾分隔字符和反斜杠的问题。
继续阅读Shell 中一对引号能避免多少问题
变量展开之后还可能继续经历分词与文件名匹配。参数里一个普通空格，就可能把原来的一条路径变成两条参数，导致命令操作完全不同的对象。
继续阅读文件传过去了，内容真的一样吗？
相同大小并不能证明内容相同，摘要比较可以发现传输或存储中的变化。
继续阅读df 说满了，du 却没那么大
文件系统的可用空间和目录中可见文件的总量，并不是同一个统计口径。挂载点、权限不足以及仍被进程持有的已删除文件，都可能让两边数字看起来对不上。
继续阅读权限问题，先检查文件再检查目录
读取脚本与执行脚本是两回事，目录的执行位还决定能否穿越路径。 能看到文件名却不能进入目录，与能读取脚本却不能直接执行，并不是同一种权限问题。排查时需要沿目标路径向上检查，而不只是给最后一个文件增加权限。
继续阅读想看执行进度，也想保留输出
直接把输出重定向到文件后，终端可能长时间没有反馈。tee 位于数据通道中间，把相同内容复制到两个去处，适合保存构建摘要或实验结果。
继续阅读cut 适合拆字段，但它不是 CSV 解析器
分隔符固定且不存在转义时，cut 能快速抽取文本列。
继续阅读重复内容统计：uniq 前面为什么常有 sort
uniq 判断的是相邻两行是否相同。输入顺序混乱时，相同内容可能分散出现，直接计数会得到多个小组，不能代表整个文件的频率。
继续阅读读大日志，先别急着打开编辑器
先查看文件开头和末尾，往往比直接打开整个大文件更高效。 日志排查通常从时间窗口开始：开头能说明文件格式，末尾能说明最近发生了什么。只读几十行既减少等待，也避免把巨大的日志一次载入编辑器。
继续阅读一个文本文件到底有多少行？
终端看起来显示了两段文字，文件内部却未必包含两个换行符。wc 的不同选项对应不同计数方式，中文字数、编码字节和换行数量之间不能直接互换。
继续阅读配置改动之前，留一份可比较的副本
修改配置前保留副本，才能比较具体变更并快速恢复。
继续阅读mkdir -p：把实验目录准备得更可靠
批量任务经常需要 input 和 output 两个目录。逐级创建会引入额外的存在性判断，-p 能处理缺少父目录的情况，也允许重复准备同一套结构。
继续阅读脚本明明在同一目录，为什么找不到文件？
从终端启动、被定时任务启动和被另一个脚本调用，得到的工作目录可能完全不同。打开相对路径时，系统不会替你寻找脚本旁边的文件，而是从进程当前目录解析。
继续阅读