工具教程 第2页

想忽略输出目录中的多数文件，只保留一份说明，写上感叹号例外却可能无效。关键问题往往是父目录已经被整体排除，Git没有继续遍历里面的文件。

网站已经连上，却迟迟不返回正文时，单独设置连接超时未必能结束等待。curl把连接阶段限制与一次传输的总时限分开，排查时要知道自己限制了哪一段。

curl的小写-o让你指定本地文件名，大写-O通常从请求URL取文件名。下载后找不到预期名称时，先核对选项大小写和保存目录，不必立即判断文件丢失。

从命令行把数值传给jq时，使用arg会得到字符串，即使内容看起来是数字。需要JSON数值、布尔或对象时，应理解argjson的解析行为，并按业务要求选择类型。

给人看的Git状态文本，不适合直接按空格或换行拆分后交给脚本。文件名本身可以含空格，某些系统还允许换行，因此应选择为机器解析设计的输出格式。

jq的双斜线运算符会对false和null等情况使用右侧结果。如果配置中的false表示用户明确关闭功能，直接补默认值可能把这项选择覆盖掉。

同一份文本文件通过curl发送，接收端得到的内容可能因选项不同而变化。尤其用@文件路径读取正文时，需要区分普通data处理与data-binary保留字节的行为。

排查修改前的内容时，可以直接查看指定提交里的文件，而不必先恢复当前文件。git show HEAD:note.txt展示的是HEAD所指提交中的路径内容，工作区修改仍然保留。

文件里连续放着多份JSON值时，jq默认会逐份运行表达式。加上slurp选项后，它先收集整个输入流为一个数组，再运行一次表达式，适合小批量汇总。

对JSON对象读取.foo时，字段不存在和字段明确写成null都可能得到null。若导入规则要区分“没有提交”与“主动清空”，应先用has检查键是否存在，再判断它的值。