5 分钟跑通第一次：让 AI 写出并运行一个能用的小脚本

很多人学 AI 编程，卡在第一步不是"难"，而是"没有让 AI 替我干成一件事"的实感。所以这一节不讲大道理，我们直接动手：把一个真实的小麻烦——一堆文件名乱七八糟、想批量改成统一格式——丢给 AI，让它写脚本，你跑通它。读完你会建立两个东西：一是"我用一句话就能让机器干活"的信心，二是一套零基础也不会出事的安全操作循环。

读这篇前你只需要装好 Python（官网下载，安装时勾上 "Add Python to PATH"），以及任意一个能聊天的 AI（网页版 Claude、DeepSeek 都行，或者直接用 Cursor / Claude Code 这类能直接动文件的工具）。

---

第一步：把需求一句话说清楚，交给 AI

假设你有一个文件夹，里面是手机导出的照片，名字像 IMG_0921.jpg、微信图片_20260101.jpg 这种乱七八糟的。你想统一改成 照片_001.jpg、照片_002.jpg。

别自己憋着想怎么写代码，直接把下面这段话发给 AI——这就是你的第一条提示词：

用 Python 写一个脚本，把指定文件夹里所有 .jpg 文件，按文件名排序后，统一重命名为「照片_001.jpg、照片_002.jpg」这种格式，序号补零到三位。要求：先打印出"原名 → 新名"的对照让我确认，加一个开关，确认无误前只预览不真改。给我完整可直接运行的代码，并告诉我怎么运行。

注意这条提示词里藏了三个好习惯，记下来，你以后提任何需求都该这么提：

• 说清输入和输出："文件夹里的 .jpg" → "照片_序号.jpg"。
• 给约束："序号补零到三位""按文件名排序"。
• 要安全网："先预览、确认前不真改"——这一句能帮你躲掉新手最容易踩的"一键改坏一整个文件夹"的坑。

---

第二步：拿到代码，跑通它

AI 会给你一段类似下面的代码。把它存成一个文件，比如 rename.py：

from pathlib import Path

# ↓ 改成你自己的文件夹路径（Windows 用 r"D:\照片" 这种写法）
FOLDER = Path(r"D:\照片")
PREFIX = "照片"
DRY_RUN = True   # True = 只预览不真改；确认无误后改成 False 再跑一次

def main():
    # 1. 找出所有 .jpg，按文件名排序，保证序号稳定
    files = sorted(FOLDER.glob("*.jpg"))
    if not files:
        print("这个文件夹里没找到 .jpg 文件，检查下 FOLDER 路径对不对")
        return

    # 2. 逐个算出新名字，打印对照
    for i, old in enumerate(files, start=1):
        new_name = f"{PREFIX}_{i:03d}.jpg"   # :03d = 补零到三位
        new_path = old.with_name(new_name)
        print(f"{old.name}  →  {new_name}")
        # 3. 只有关掉预览开关时，才真的改名
        if not DRY_RUN:
            old.rename(new_path)

    if DRY_RUN:
        print("\n以上是预览。确认没问题就把 DRY_RUN 改成 False，再运行一次。")
    else:
        print(f"\n搞定，共重命名 {len(files)} 个文件。")

if __name__ == "__main__":
    main()

怎么运行：打开终端（Windows 是 PowerShell，Mac 是终端），切到脚本所在文件夹，敲：

python rename.py

你应该看到什么

第一次跑（DRY_RUN = True），终端会打印一串对照，但文件夹里什么都没变：

IMG_0921.jpg  →  照片_001.jpg
微信图片_20260101.jpg  →  照片_002.jpg
...
以上是预览。确认没问题就把 DRY_RUN 改成 False，再运行一次。

看一眼对照表，新名字符合预期？那就把代码里的 DRY_RUN = True 改成 False，再 python rename.py 一次。这次文件名才真的改掉，终端打印 搞定，共重命名 N 个文件。

这一刻很关键：你用一句话，让机器替你干了一件原本要手动改几十次的活。这就是 AI 编程最朴素也最上瘾的体验。

---

第三步：把这段代码看懂（别当黑盒）

能跑只是开始。哪怕你零基础，也花两分钟把它读一遍——AI 写的代码你看得懂，才谈得上让它帮你改。

• from pathlib import Path：借用 Python 自带的"文件路径工具箱"。Path 能帮你找文件、拼名字、改名，不用自己拼字符串。
• FOLDER、PREFIX、DRY_RUN 这三个全大写的变量放在最上面，是 AI 故意把"你需要改的旋钮"集中放好，方便你调。
• FOLDER.glob("*.jpg")：在文件夹里捞出所有 .jpg。sorted(...) 把它们排好序，保证每次跑出来的序号一致。
• f"{PREFIX}_{i:03d}.jpg"：拼新名字。{i:03d} 是"把数字 i 补零到三位"，所以是 001 而不是 1。
• if not DRY_RUN: old.rename(...)：只有当你关掉预览开关，才真正执行改名。这就是那张"安全网"。

看懂这几行，你就明白了：所谓写脚本，本质就是"找到一批东西 → 按规则给每个算个结果 → 决定要不要落地"。

---

故障排查：跑不通时照这张表查

第一次跑脚本十有八九会卡一下，别慌，照顺序查：

现象	最可能的原因	怎么办
python 不是内部或外部命令	装 Python 时没勾 PATH	重装勾上 "Add Python to PATH"，或用 py rename.py 试试
No such file or directory / 路径报错	FOLDER 路径写错或没加 r""	Windows 路径前加 r，如 r"D:\照片"；确认文件夹真存在
打印"没找到 .jpg 文件"	文件夹里是 .png/.jpeg，或路径指错了	把 *.jpg 改成 *.png，或检查 FOLDER
报一长串红色英文	各种语法/缩进问题	把整段报错原样复制，回喂给 AI："运行报这个错，帮我看看：[粘贴报错]"
改完发现序号乱了	文件名排序不是你想的顺序	跟 AI 说"我想按拍摄时间排序"，让它改排序逻辑

最后一行是这套工作流的精髓：报错不是你的失败，它是你和 AI 之间的对话原料。 你不需要看懂报错，只要原样喂回去，AI 多半一眼就知道哪错了。喂的时候有个小技巧：把报错从头到尾整段贴回去，别只截最后一行——真正的原因往往藏在中间那几行 File "...", line N 里，少贴了 AI 就得靠猜。

再多说一句上手心态：第一次跑脚本卡壳是常态，不是你笨。哪怕干了十年的程序员，装个环境、对个路径也照样踩坑，区别只在他们见得多、不当回事。你要做的不是"一次写对"，而是把每个卡点原样丢给 AI，一个一个拆。先在一个装了几张不重要图片的测试文件夹里跑，跑顺了再对真文件夹动手——这一步能帮你把"改坏"的代价降到零。心态放平，你会发现所谓编程，大半时间就是"试一下、看报错、问一句、再试一下"。

---

玩出花样：两个变体

会跑之后，让 AI 帮你改两个版本，你会发现这脚本能变成真正顺手的小工具。

变体一：保留原始拍摄日期

跟 AI 说：

改一下，新文件名带上原文件的修改日期，格式像「2026-01-01_照片_001.jpg」。

它会教你用 old.stat().st_mtime 取文件时间。你不用记这个 API，知道"能这么干"就够了。

变体二：做成能拖文件夹进去的版本

改成运行时让我输入文件夹路径，而不是写死在代码里。

AI 会把 FOLDER = Path(...) 换成 FOLDER = Path(input("把文件夹路径粘进来："))。这样脚本就能复用到任何文件夹，不用每次改代码。

---

动手挑战

别只看，挑一个动手做：

1. 让脚本只重命名"今年拍的"照片，今年以前的跳过。（提示：把需求这么说给 AI，让它加个日期过滤。）
2. 把它改成"批量给一堆 .txt 文件加统一前缀"的版本——你会发现核心逻辑几乎没变，这就是一通百通。

卡住了，记住唯一的口诀：把你想要的效果 + 当前的代码 + 报错（如果有），一起发给 AI。

---

小结 · 你现在掌握了什么

• 你能把一句话需求交给 AI，拿到一段真能跑的脚本，并在自己电脑上看到结果。
• 你看懂了一个脚本的基本骨架："找一批东西 → 按规则算 → 要不要落地"。
• 你掌握了零基础也安全的工作循环：先备份、开预览、小步试、报错回喂 AI。

这套"提需求 → 跑通 → 看懂 → 改坏再修好"的循环，就是后面所有 AI 编程的底层节奏，不管你以后做网站还是做产品都一样。

下一步：信心建立起来后，去看整条 AI 编程阶梯的全貌，知道自己接下来该练什么；想直接对照路线找位置，看三支柱路线图。

👉 看看我们的 AI 编程实战体系课，或逛 AI 编程教程大全 把基本功打扎实。