VS Code + Python开发环境配置：从安装插件到虚拟环境，一次配好永不折腾

工欲善其事，必先利其器。一个配置良好的开发环境能让你的编程效率翻倍。本篇详细介绍 VS Code 的 Python 开发配置、虚拟环境管理、Jupyter Notebook 的使用，以及常用插件推荐。

- [1.3 基础设置](#13-基础设置)

• 2. Python扩展配置
  • 2.1 必装扩展
  • 2.2 Python扩展配置
  • 2.3 选择Python解释器
• 3. 代码运行与调试
  • 3.1 运行Python代码
  • 3.2 调试配置
  • 3.3 调试技巧
• 4. 虚拟环境管理
  • 4.1 什么是虚拟环境
  • 4.2 创建虚拟环境(通过uv组织命令)
  • 4.3 激活与退出虚拟环境
  • 4.4 在VS Code中使用虚拟环境
  • 4.5 依赖管理
• 5. Jupyter Notebook配置
  • 5.1 什么是Jupyter Notebook
  • 5.2 安装Jupyter
  • 5.3 在VS Code中使用Jupyter
  • 5.4 Jupyter基本操作
• 6. 常用插件推荐
  • Python开发必备
  • 代码质量
  • 效率提升
  • 界面美化
• 7. 工作区配置
  • 7.1 settings.json配置
  • 7.2 launch.json调试配置
• 8. 常见问题与解决
  • ❌ 问题1：PowerShell无法激活虚拟环境
  • ❌ 问题2：VS Code找不到Python解释器
  • ❌ 问题3：import报错但代码能运行
  • ❌ 问题4：终端中pip安装的包在代码中import失败
  • ❌ 问题5：Jupyter Notebook无法运行
• 9. 总结
  • 🔑 核心要点
  • ✅ 配置检查清单
  • 📁 推荐的项目结构
• 📖 下一步学习

1. VS Code安装与基础配置

1.1 下载与安装

下载地址：https://code.visualstudio.com/

安装步骤：

1. 下载Windows版安装包（User Installer或System Installer均可）
2. 运行安装程序
3. 建议勾选以下选项：
   • ✅ 将”通过Code打开”操作添加到Windows资源管理器文件上下文菜单
   • ✅ 将”通过Code打开”操作添加到Windows资源管理器目录上下文菜单
   • ✅ 将Code注册为受支持的文件类型的编辑器
   • ✅ 添加到PATH

1.2 界面介绍

┌─────────────────────────────────────────────────────────────┐
│  菜单栏 (File, Edit, View, Go, Run, Terminal, Help)         │
├─────┬───────────────────────────────────────────┬───────────┤
│     │                                           │           │
│ 活  │                                           │  侧边栏   │
│ 动  │              编辑器区域                    │ (大纲等)  │
│ 栏  │           (代码编辑区)                     │           │
│     │                                           │           │
├─────┴───────────────────────────────────────────┴───────────┤
│                        面板区域                              │
│              (终端、输出、问题、调试控制台)                   │
├─────────────────────────────────────────────────────────────┤
│  状态栏 (Git分支、错误警告、行列号、编码、语言模式)           │
└─────────────────────────────────────────────────────────────┘

快捷键速查：

1.3 基础设置

按Ctrl+,打开设置，推荐配置：

2. Python扩展配置

2.1 必装扩展

按Ctrl+Shift+X打开扩展市场，搜索并安装以下扩展：

可选但推荐：

2.2 Python扩展配置

安装Python扩展后，打开设置（Ctrl+,），搜索python进行配置：

{
    // Python路径（通常自动检测）
    "python.defaultInterpreterPath": "python",
    
    // 代码分析
    "python.analysis.typeCheckingMode": "basic",
    "python.analysis.autoImportCompletions": true,
    
    // 代码格式化（推荐使用black）
    "python.formatting.provider": "black",
    
    // 代码检查（推荐使用pylint或flake8）
    "python.linting.enabled": true,
    "python.linting.pylintEnabled": true
}

2.3 选择Python解释器

1. 按Ctrl+Shift+P打开命令面板
2. 输入Python: Select Interpreter
3. 选择你安装的Python版本

💡 提示：状态栏左下角会显示当前选择的Python版本，点击可快速切换。

3. 代码运行与调试

3.1 运行Python代码

方法1：右键运行

在编辑器中右键 → “在终端中运行Python文件”

方法2：快捷键运行

• Ctrl+F5：运行（不调试）
• F5：调试运行

方法3：Code Runner扩展

安装Code Runner扩展后，点击右上角的▶按钮或按Ctrl+Alt+N运行。

3.2 调试配置

设置断点：点击代码行号左侧，出现红点即为断点。

启动调试：

1. 按F5或点击左侧活动栏的”运行和调试”图标
2. 首次运行会提示创建launch.json配置文件
3. 选择”Python File”即可

调试控制：

3.3 调试技巧

查看变量：

• 调试时，左侧”变量”面板显示当前作用域的所有变量
• 鼠标悬停在代码中的变量上可查看值
• 在”监视”面板添加表达式实时监控

条件断点：

右键断点 → “编辑断点” → 输入条件表达式（如i > 10）

调试控制台：

在调试控制台可以执行Python表达式，查看或修改变量值。

# 示例：调试时在控制台输入
>>> len(my_list)
10
>>> my_list[0]
'hello'

4. 虚拟环境管理

4.1 什么是虚拟环境

虚拟环境是一个独立的Python运行环境，拥有独立的包目录。

为什么需要虚拟环境：

💡 类比：虚拟环境就像是给每个项目分配一个独立的”工具箱”，互不干扰。

4.2 创建虚拟环境(通过uv组织命令)

方法1：使用 CMD 方式（最简单）

# 1. 打开 CMD（Win+R 输入 cmd）
# 2. 进入项目目录
cd /d e:\Python-Programing\02-Daily-Exercise

# 3. 创建虚拟环境
uv venv .venv

# 4. 激活虚拟环境（无需额外配置）
.venv\Scripts\activate.bat

# 5. 验证激活（提示符显示 (.venv)）
# 6. 运行脚本
uv run src/hello.py

方法2：PowerShell 方式（功能强大）

# 1. 打开 PowerShell
# 2. 进入项目目录
cd "e:\Python-Programing\02-Daily-Exercise"

# 3. 创建虚拟环境
uv venv .venv

# 4. 临时允许脚本执行（每次新窗口都需要）
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process

# 5. 激活虚拟环境
.venv\Scripts\activate

# 6. 运行脚本
uv run src/hello.py

# 7. 退出虚拟环境
deactivate

4.3 激活与退出虚拟环境

Windows（CMD）：

# 激活
.venv\Scripts\activate

# 退出
deactivate

Windows（PowerShell）：

# 激活
.venv\Scripts\Activate.ps1

# 如果报错"禁止运行脚本"，先执行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# 退出
deactivate

激活后的变化：

# 激活前
C:\Users\xxx>

# 激活后（注意前面的(.venv)标识）
(.venv) C:\Users\xxx>

4.4 在VS Code中使用虚拟环境

1. 在项目根目录创建虚拟环境（.venv）
2. 按Ctrl+Shift+P → Python: Select Interpreter
3. 选择.venv目录下的Python解释器
4. VS Code会自动在终端中激活虚拟环境

💡 提示：VS Code通常会自动检测项目中的虚拟环境，并提示你选择。

💡 工程师手记：虚拟环境是Python开发中最容易被新手忽略、但最重要的概念。我刚学Python时把所有包装在全局环境里，结果项目A要pandas 1.x，项目B要pandas 2.x，升级后A就跑不了了。养成习惯：每个项目第一件事就是uv init或uv venv，永远不在全局环境装包。

（建议替换为你自己的真实经历，读者会更有共鸣）

4.5 依赖管理

导出依赖：

# 导出当前环境的所有包
pip freeze > requirements.txt

requirements.txt示例：

pandas==2.0.3
openpyxl==3.1.2
python-docx==0.8.11

安装依赖：

# 根据requirements.txt安装所有依赖
pip install -r requirements.txt

最佳实践：

MyProject/
├── .venv/              # 虚拟环境目录（不要提交到Git）
├── src/                # 源代码
├── requirements.txt    # 依赖列表（提交到Git）
├── README.md
└── .gitignore          # 添加.venv/到忽略列表

5. Jupyter Notebook配置

5.1 什么是Jupyter Notebook

Jupyter Notebook是一个交互式的计算环境，可以在网页中编写和运行代码，并实时查看结果。

特点：

适用场景：

• 数据分析与探索
• 学习和教学
• 快速原型验证
• 报告生成

5.2 安装Jupyter

# 安装Jupyter
pip install jupyter

# 或安装JupyterLab（更现代的界面）
pip install jupyterlab

启动Jupyter：

# 启动Jupyter Notebook
jupyter notebook

# 启动JupyterLab
jupyter lab

浏览器会自动打开Jupyter界面。

5.3 在VS Code中使用Jupyter

VS Code内置了Jupyter支持，无需打开浏览器。

创建Notebook：

1. Ctrl+Shift+P → Create: New Jupyter Notebook
2. 或直接创建.ipynb文件

选择内核：

点击右上角的”选择内核”，选择Python解释器。

5.4 Jupyter基本操作

Cell类型：

快捷键（命令模式，按Esc进入）：

快捷键（编辑模式）：

示例Notebook：

# Cell 1 (Markdown)
# 数据分析示例
这是一个简单的数据分析演示。

# Cell 2 (Code)
import pandas as pd
import matplotlib.pyplot as plt

# Cell 3 (Code)
# 创建示例数据
data = {'月份': ['1月', '2月', '3月', '4月'],
        '销售额': [100, 150, 120, 180]}
df = pd.DataFrame(data)
df

# Cell 4 (Code)
# 绘制图表
plt.figure(figsize=(8, 4))
plt.bar(df['月份'], df['销售额'])
plt.title('月度销售额')
plt.show()

6. 常用插件推荐

Python开发必备

代码质量

效率提升

界面美化

7. 工作区配置

7.1 settings.json配置

在项目根目录创建.vscode/settings.json，配置项目级设置：

{
    // Python解释器路径
    "python.defaultInterpreterPath": "${workspaceFolder}/.venv/Scripts/python.exe",
    
    // 代码格式化
    "python.formatting.provider": "black",
    "editor.formatOnSave": true,
    
    // 代码检查
    "python.linting.enabled": true,
    "python.linting.pylintEnabled": true,
    
    // 文件排除
    "files.exclude": {
        "**/__pycache__": true,
        "**/*.pyc": true,
        ".venv": true
    },
    
    // 终端默认激活虚拟环境
    "python.terminal.activateEnvironment": true,
    
    // 保存时自动整理import
    "editor.codeActionsOnSave": {
        "source.organizeImports": true
    }
}

7.2 launch.json调试配置

在.vscode/launch.json中配置调试选项：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: 当前文件",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "justMyCode": true
        },
        {
            "name": "Python: 主程序",
            "type": "python",
            "request": "launch",
            "program": "${workspaceFolder}/main.py",
            "console": "integratedTerminal",
            "args": ["--config", "config.json"]
        }
    ]
}

8. 常见问题与解决

❌ 问题1：PowerShell无法激活虚拟环境

错误信息：无法加载文件...因为在此系统上禁止运行脚本

解决：

# 以管理员身份运行PowerShell，执行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

❌ 问题2：VS Code找不到Python解释器

解决：

1. 确认Python已正确安装
2. Ctrl+Shift+P → Python: Select Interpreter → 手动选择
3. 如果列表为空，点击”输入解释器路径”手动指定

❌ 问题3：import报错但代码能运行

原因：Pylance未正确识别虚拟环境

解决：

1. 确认选择了正确的Python解释器
2. 重启VS Code
3. 在settings.json中添加：

{
    "python.analysis.extraPaths": ["${workspaceFolder}/src"]
}

❌ 问题4：终端中pip安装的包在代码中import失败

原因：终端使用的Python与VS Code选择的不一致

解决：

1. 检查终端中的Python路径：where python
2. 确保与VS Code右下角显示的解释器一致
3. 使用python -m pip install代替pip install

❌ 问题5：Jupyter Notebook无法运行

解决：

1. 确认安装了jupyter和ipykernel：

pip install jupyter ipykernel

2. 注册内核：

python -m ipykernel install --user --name=myenv

9. 总结

🔑 核心要点

✅ 配置检查清单

• VS Code已安装并配置中文
• Python扩展和Pylance已安装
• 能正确选择Python解释器
• 能创建和激活虚拟环境
• 能运行和调试Python代码
• 能使用Jupyter Notebook
• 已配置国内pip镜像源

📁 推荐的项目结构

MyProject/
├── .vscode/
│   ├── settings.json      # 项目设置
│   └── launch.json        # 调试配置
├── .venv/                 # 虚拟环境（不提交Git）
├── src/                   # 源代码
│   ├── __init__.py
│   └── main.py
├── tests/                 # 测试代码
├── data/                  # 数据文件
├── notebooks/             # Jupyter笔记本
├── requirements.txt       # 依赖列表
├── README.md              # 项目说明
└── .gitignore             # Git忽略文件

参考资料

• VS Code Python文档
• uv官方文档
• Jupyter官方文档

� 系列导航

• 上一篇：01 - Python编程入门指南
• 当前：02 - Python开发环境配置
• 下一篇：03 - Python基本语法与代码风格