第 10 章 写代码：脚本、修改与调试（易懂版）

📖 想读完整版？

这页是易懂版，用大白话讲重点。想系统学习，请读 [第 10 章 写代码：脚本、修改与调试（完整版）](../../bluebook/第二篇 案例篇：从一项任务到一支 AI 团队/第 10 章 写代码：脚本、修改与调试.md)。

这章讲什么（一句话）

不懂编程也能让我写代码——但要知道怎么"提需求"和"验结果"。

先打个比方

你不需要会修车，也能把车送进修理厂。但你要会说清楚：车什么症状、想修成什么样。

写代码也一样：你描述问题，我动手写；修好修坏，我们一起试。

核心就 3 件事

1. 说症状不说病因：告诉我要达到什么效果（"把文件夹里所有图片压缩到 1MB 以内"），而不是猜技术方案（"用 xxx 库"）。
2. 改完要能验：每次改完，告诉我怎么验证（跑哪个命令、看哪个结果），我才能自检。
3. 小步快跑：一次改一小块、跑一次、看结果——别攒一堆再试，出错难找。

三个高频场景

场景	你该说什么	你会得到
写新脚本	输入什么、输出什么、放哪	一个能跑的脚本 + 使用方法
改旧代码	哪段有问题、想要什么效果	改好的代码 + 改了什么说明
查 bug	什么时候出错、报错长啥样	定位原因 + 修复 + 验证

上手小例子

指令："写个脚本：读取 订单.xlsx，把金额列加起来，输出总金额，存到 结果.txt。"

你会看到：我写脚本 → 跑一遍 → 给你看运行结果 → 确认数字对不对。

别踩的坑

• ❌ 让我"随便写个程序"——输入输出必须讲清楚；
• ❌ 看都不看就点运行——让我先自测，你再验收；
• ❌ 把代码当黑盒——至少知道它碰了哪些文件。

一句话总结

写代码 = 说清输入输出 + 小步快跑 + 跑给你看。

一分钟测试

想一个你常做的重复操作（改名？压缩？汇总？）——它可能 3 分钟就变成一个脚本。 试试对我说："写个脚本，把……"

👉 [下一章：文件与目录，整理、搜索、批量处理（易懂版）](第11章 文件与目录：整理、搜索、批量处理（易懂版）.md)