第一章：环境准备——搭建你的"武器库"¶

在写代码之前，我们需要先装好两样东西：代码编辑器（VSCode） 和 Python 解释器。

1. 为什么选 VSCode？¶

市面上有很多 AI 辅助编程工具，让我们先认识一下：

2. 下载与安装 VSCode¶

验证安装成功： 打开 VSCode，看到欢迎界面说明安装完成 ✅

3. 安装 Python 插件¶

VSCode 本身只是一个文本编辑器，需要安装插件才能"理解" Python 代码。

插件就像手机 App——安装 Python 插件后，VSCode 就能：

• 🎨 让代码变为彩色，可以进一步辨识不同代码内容（语法高亮）
• 💡 自动补全后续代码（输入几个字母就提示剩余部分）
• 🔴 即时报错提示（写错字符会立刻下划线标红，“预判”错误）

安装步骤：

1. 点击左侧边栏的 扩展图标（四个方块的图标），或按 Ctrl+Shift+X
2. 在搜索框输入 Python
3. 找到 Microsoft 发布的 Python 插件（蓝色微软图标）
4. 点击 安装

4. 安装 Python¶

安全下载（非常重要！）¶

安装步骤（Windows）¶

1. 打开 https://www.python.org/downloads/
2. 点击黄色按钮 "Download Python 3.x.x"（最新稳定版）
3. 双击下载的 .exe 文件

4. 在安装界面**必须勾选** ⚠️：

   

   • ☑️ Add python.exe to PATH（让终端能直接运行 python 命令）

5. 点击 "Install Now"

6. 安装完成后，如果看到 "Disable path length limit" 按钮，点击它 ⚠️

   

   这会解除 Windows 的路径长度限制（Windows 默认只允许 260 个字符的路径，现代开发常常超过这个长度）。

验证安装¶

安装完成后，打开终端（Windows 按 Win+R 输入 cmd，macOS 打开"终端"），运行：

python --version

看到类似 Python 3.1x.x 的输出，就说明 Python 已经正确安装了 ✅

再验证 pip（Python 的包管理器）：

pip --version

输出类似 pip 25.x from ... (python 3.1x) 即为成功。

5. 虚拟环境（venv）¶

为什么需要虚拟环境？¶

使用 VSCode 创建虚拟环境¶

VSCode 的 Python 插件内置了虚拟环境管理功能：

1. 在 VSCode 中打开你的项目文件夹（文件 → 打开文件夹）
2. 按 Ctrl+Shift+P 打开命令面板
3. 输入 Python: Create Environment，回车
4. 选择 Venv
5. 选择你刚安装的 Python 解释器版本
6. 等待进度条完成

创建完成后，项目根目录会出现一个 .venv 文件夹，VSCode 右下角状态栏会显示当前 Python 解释器路径。

激活虚拟环境¶

VSCode 会在打开项目时**自动激活**虚拟环境。你也可以在集成终端（或新建的终端窗口）中手动激活：

.\.venv\Scripts\Activate.ps1

source .venv/bin/activate

激活成功后，终端提示符前会出现 (.venv) 前缀：

(.venv) PS D:\my-project>

6. pip 包管理入门¶

pip 是 Python 的包管理器，相当于"应用商店"——通过一条命令就能安装别人写好的功能。

安装你的第一个库¶

让我们安装 tqdm（一个在终端显示进度条的工具）来练习：

pip install tqdm

安装完成后，测试一下：

from tqdm import tqdm
import time

for i in tqdm(range(100)):
    time.sleep(0.02)  # 模拟耗时操作

运行后会看到一个进度条在终端中推进——这就是 pip 的魔力 ✨

常用库速览¶

笔者常用库如下，可供参考：

本教程需要的库可以一次性安装：

pip install openai python-dotenv pandas openpyxl

本章小结¶

✅ VSCode 安装完成，Python 插件就位
✅ Python 从官网下载，PATH 和路径限制已配置
✅ 虚拟环境已创建并激活
✅ 核心依赖库已安装

下一章： API 集成入门 → 我们将写出第一份调用大模型的代码！