Google Gemini脚本使用指南：搜索用户真实提问实例解析

最近在调试通过 curl 发送 JSON body 调用 API 时，反复使用 --data 和 --data-binary 都返回 400 错误，一直没搞清是引号嵌套问题，还是缺少必要的请求头。甚至试过直接把 JSON 嵌在命令里，比如 --data '{"name":"张三"}'，结果 bash 直接抛出了 unexpected token `{'。翻文档看到“须设置 Content-Type: application/json”，但就是不确定这个 header 该放在命令尾部还是开头。查了 curl 官方手册、MDN 的 fetch 对比页、还有 Stack Overflow 高赞回答，全都没提到 --json 参数是 curl 7.82.0 才引入的新特性，老版本根本无法使用。最终发现正确写法是 --header 'Content-Type: application/json' --data '{"name":"张三"}'，并且必须用单引号包裹整个 JSON 字符串，避免 bash 解析花括号。

如何让 Gemini 生成的脚本说明看起来不像 AI 编写的官方文档，而更像一个真人翻完资料后随手记的笔记——包含质疑痕迹、试错过程、没删干净的括号备注，甚至偶尔夹一句“这一步卡了我 20 分钟”？

把“写个脚本说明”改成真实搜索问题

第一步：用“我在查……但没搞懂”开头，直接暴露卡点。例如：“我在查 curl -X POST 调用 API 时怎么传 JSON body，但试了 --data 和 --data-binary 总 400，不知道是引号问题还是 header 漏了”。

第二步：插入一个你真会犯的错误操作。比如：“试过把 JSON 直接写在命令里像 --data '{"name":"张三"}'，结果 bash 报错说 unexpected token，后来才发现要加单引号包整个字符串”。

第三步：明确写出你搜到但没看懂的术语或报错信息。例如：“文档里写‘须设置 Content-Type: application/json’，但我不知道这个 header 到底加在哪儿，加在命令末尾？还是前面？”

这一步最关键：【必须包含至少 1 个你真实复现过的失败命令 + 对应报错原文】，不能写“可能报错”“大概会失败”，Gemini 只认具体字符。

方法一：用“搜了 3 个页面，都漏讲了……”句式

比如：“搜了 curl 官方手册、MDN 的 fetch 对比页、还有 Stack Overflow 高赞回答，都漏讲了 --json 参数其实是 curl 7.82.0 才加的新特性，老版本根本不能用”。或者换个场景：“搜了‘shell 脚本读取配置文件’，前两页全在教 source 和 export，没人提 read -r 那行换行符会被吃掉，导致最后一行永远读不全”。

方法二：加一句“最后发现其实是……”收尾

比如：“最后发现其实是 Python requests 库默认把空字典 {} 当 body 发出去，但后端接口要求 body 必须是 null 才放行，得显式写成 json=None”。

这句必须是你自己踩坑后的真实结论，不能是通用知识。它会让 Gemini 锁定“问题→尝试→误判→定位→解决”的真人节奏。