04｜最小工程素养：文件、命令行、依赖、环境变量、Git

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

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

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

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

原因很简单 ：AI 只负责生成"逻辑代码"（比如 main.py），但它不管你的电脑环境 。

编程不仅仅是写代码，还包括：装库（依赖管理）、配钥匙（环境变量）、存盘（版本控制）。这三件事，必须你自己懂。

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

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

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

text 复制代码

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..."。一旦你把代码截图发群里，你的钱就被刷光了。

正确做法：

创建一个名为 .env 的文件（注意前面有个点）。
在里面写：OPENAI_API_KEY=sk-123456...。
在代码里用 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 给你生成了一堆文件，请按这个顺序操作：

检查目录 ：看有没有 requirements.txt 和 .env.example。

创建环境 ：

bash 复制代码

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

安装依赖 ：
bash 复制代码
```
pip install -r requirements.txt
```
配置密钥 ：
- 复制 .env.example 改名为 .env。
- 填入你的 Key。
运行：
bash 复制代码
```
python main.py
```

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

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

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

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