本篇目标：补齐 AI 无法帮你做的“脏活累活”。学完这篇，你不再会被“环境报错”卡住，能真正把代码跑起来。

---

一、为什么 AI 给了代码你却跑不起来？

很多新手遇到过这种情况：

1. 让 AI 写个 Python 爬虫。
2. AI 给了代码，看起来很完美。
3. 你一运行，终端报错：ModuleNotFoundError，或者 KeyError: 'OPENAI_API_KEY'。
4. 你把报错发给 AI，它让你“安装依赖”，你照做，结果又报一堆红字。

原因很简单：AI 只负责生成“逻辑代码”（比如 main.py），但它不管你的电脑环境。
编程不仅仅是写代码，还包括：装库（依赖管理）、配钥匙（环境变量）、存盘（版本控制）。这三件事，必须你自己懂。

---

二、五个必须掌握的“工程积木”

1. 项目结构（Project Structure）：别把文件乱放

不要把所有代码都塞进一个文件夹。一个正经的项目应该长这样：

my-project/
├── .env                # 放密钥（绝对不能给别人看！）
├── .gitignore          # 告诉 Git 哪些文件不要上传（比如 .env）
├── main.py             # 主程序入口
├── requirements.txt    # 依赖清单（告诉别人要装什么库）
├── README.md           # 说明书（怎么跑这个项目）
└── utils/              # 工具函数文件夹
    └── helper.py

AI 提示：当你让 AI 写项目时，直接加一句：“请帮我设计一个标准的项目目录结构，并解释每个文件的作用。”

2. 命令行（Terminal）：你的指挥台

你不需要背下所有 Linux 命令，但这几个必须会：

• ls (Mac) / dir (Win)：看看当前文件夹里有啥。
• cd 文件夹名：进入某个文件夹。
• cd ..：回到上一级。
• python main.py：运行你的程序。
• pip install 包名：安装工具包。

AI 提示：如果你不知道怎么运行，直接把当前目录截图发给 AI，问它：“我现在在这个目录，我想运行这个项目，终端命令该怎么敲？”

3. 依赖管理（Dependencies）：给代码“配药”

Python 代码通常需要调用别人的库（比如 requests）。如果你的电脑没装，代码就跑不起来。

• requirements.txt：这是一张“药方”。里面写着：requests==2.28.1。
• 安装方法：pip install -r requirements.txt。

避坑：

• 虚拟环境（venv）：强烈建议每个项目都有独立的“药箱”，不要混用。
• AI 提示：“请给我生成 requirements.txt，并告诉我怎么创建虚拟环境来安装它们。”

4. 环境变量（Environment Variables）：安全的放钥匙

千万不要在代码里写 api_key = "sk-123456..."。一旦你把代码截图发群里，你的钱就被刷光了。

正确做法：

1. 创建一个名为 .env 的文件（注意前面有个点）。
2. 在里面写：OPENAI_API_KEY=sk-123456...。
3. 在代码里用 os.getenv('OPENAI_API_KEY') 读取。

AI 提示：“请把代码里的敏感信息改成从环境变量读取，并告诉我 .env 文件该怎么写。”

5. Git（版本控制）：后悔药

AI 经常改坏代码。如果你没用 Git，你就回不去了。

• git init：开始记录。
• git add .：把改动放入暂存区。
• git commit -m "加了新功能"：存个档。
• IDE 里的 Git：现在的 Cursor/VS Code 都有可视化的 Git 面板，点一下“勾”就是 Commit，不需要敲命令。

AI 提示：“我刚才改坏了，怎么用 Git 回滚到上一个版本？”

---

三、实战：从 0 拉起一个项目（SOP）

当你从 GitHub 下载了一个 AI 项目，或者 AI 给你生成了一堆文件，请按这个顺序操作：

1. 检查目录：看有没有 requirements.txt 和 .env.example。
2. 创建环境：

   python -m venv venv        # 创建虚拟环境
   source venv/bin/activate   # 激活（Mac）
   # Windows: venv\Scripts\activate
   

3. 安装依赖：

   pip install -r requirements.txt
   

4. 配置密钥：
   • 复制 .env.example 改名为 .env。
   • 填入你的 Key。
5. 运行：

   python main.py
   

---

本篇产出：项目启动检查清单

每次跑新项目，对照这个表打钩：

检查项	为什么要做	状态
有独立文件夹吗？	防止文件混在一起，乱套。	[ ]
创建虚拟环境了吗？	防止这个项目的库把别的项目搞挂。	[ ]
装好依赖了吗？	解决 ModuleNotFoundError。	[ ]
配置 .env 了吗？	解决 AuthError，保护钱包。	[ ]
Git 初始化了吗？	防止改坏了回不去。	[ ]
阅读 README 了吗？	90% 的坑都在文档里写了。	[ ]

---

下一步：基础打好了，我们终于可以开始“说话”了。下一章我们将进入“正确提问”，教你如何把脑子里的模糊想法，变成 AI 能听懂的“规格说明书”。