最佳实践：使用 .vscode/settings.json + 虚拟环境

核心原理

VS Code 通过以下方式识别 Python 解释器：

1. 项目根目录的 .vscode/settings.json（优先级最高）
2. 虚拟环境（推荐方式）
3. 全局默认解释器

强烈建议：每个项目创建独立虚拟环境，这是 Python 开发的最佳实践！

使用虚拟环境（推荐！）

步骤 1：为项目创建虚拟环境

# 进入你的项目目录
cd your-ai-test-project

# 创建虚拟环境（Python 3.9 示例）
python3.9 -m venv .venv

# Windows 用户也可以用：
# py -3.9 -m venv .venv

步骤 2：激活虚拟环境并安装依赖

# Linux/Mac
source .venv/bin/activate

# Windows
.venv\Scripts\activate

# 安装项目依赖
pip install dashscope pandas

步骤 3：在 VS Code 中选择解释器

1. 打开项目文件夹：File → Open Folder
2. 按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（Mac）
3. 输入 Python: Select Interpreter
4. 选择 .venv/bin/python（Linux/Mac）或 .venv\Scripts\python.exe（Windows）

VS Code 会自动在 .vscode/settings.json 中记录这个选择

步骤 4：验证配置

创建 .vscode/settings.json 文件（如果不存在）：

{
   "python.defaultInterpreterPath": ".\\venv\\Scripts\\python.exe",      
   "python.terminal.activateEnvironment": true
}

Windows 用户注意：路径应为 ".\\venv\\Scripts\\python.exe"

高级技巧：多项目管理模板

项目结构示例

1your-projects/
2├── ai-test-generator/           # Python 3.9 项目
3│   ├── .venv/
4│   ├── .vscode/settings.json
5│   └── main.py
6├── ml-experiments/              # Python 3.11 项目  
7│   ├── .venv/
8│   ├── .vscode/settings.json
9│   └── train.py
10└── legacy-scripts/              # Python 3.7 项目
11    ├── .venv/
12    ├── .vscode/settings.json
13    └── old_script.py

每个项目的 .vscode/settings.json

ai-test-generator/.vscode/settings.json:

1{
2    "python.defaultInterpreterPath": ".\\venv\\Scripts\\python.exe",
3    "python.terminal.activateEnvironment": true,
4    "python.linting.enabled": true,
5    "python.formatting.provider": "black"
6}

ml-experiments/.vscode/settings.json:

1{
2    "python.defaultInterpreterPath": ".\\venv\\Scripts\\python.exe",
3    "python.terminal.activateEnvironment": true,
4    "python.linting.enabled": true,
5    "python.analysis.typeCheckingMode": "basic"
6}

验证配置是否生效

查看状态栏

VS Code 底部状态栏会显示当前使用的 Python 版本：

常见问题解决

问题1：VS Code 找不到虚拟环境

解决方案：

1. 确保虚拟环境在项目根目录（推荐命名为 .venv）
2. 重启 VS Code
3. 手动在命令面板中选择解释器

问题2：终端没有自动激活虚拟环境

解决方案：确保 .vscode/settings.json 包含：

{
    "python.terminal.activateEnvironment": true
}

问题3：团队协作时路径不一致

解决方案：

• 使用相对路径（如 "./.venv/bin/python"）
• 在项目 README 中说明 Python 版本要求
• 使用 requirements.txt 或 pyproject.toml 管理依赖

 最佳实践总结

实践	推荐度	说明
每个项目独立虚拟环境	⭐⭐⭐⭐⭐	避免依赖冲突
虚拟环境命名为 .venv	⭐⭐⭐⭐⭐	VS Code 默认识别
使用 .vscode/settings.json	⭐⭐⭐⭐⭐	项目配置可版本控制
在 README 中说明 Python 版本	⭐⭐⭐⭐	团队协作友好
避免使用全局 Python	⭐⭐⭐	除非简单脚本