VS Code 中 Python 开发环境的配置指南
VS Code 中 Python 开发环境的配置指南
在 VS Code 中配置 Python 开发环境是入门 Python 的关键步骤，以下是完整、简洁的配置指南（适用于 Windows/macOS/Linux），包含核心插件、解释器配置、运行调试、代码格式化等核心功能：
一、前置准备：安装 Python 解释器
VS Code 本身不自带 Python 解释器，需先单独安装：
- 下载 Python 官网地址：https://www.python.org/downloads/
Windows：勾选
Add Python to PATH（自动添加环境变量，关键！），然后默认安装。macOS/Linux：系统自带 Python2，需额外安装 Python3
macOS：
brew install python3Ubuntu：
sudo apt install python3 python3-pip
- 验证安装 打开终端（Windows：cmd/PowerShell；macOS/Linux：Terminal），输入以下命令，能正常显示版本号即为安装成功：
python --version # Windows 通常显示 Python3.x；若显示 Python2.x，改用 python3 --version
pip --version # 包管理器（Python 自带），验证是否可用
二、VS Code 核心配置步骤
1. 安装 Python 插件（必装）
打开 VS Code → 左侧「扩展」面板（快捷键 Ctrl+Shift+X），搜索并安装以下插件：
Python（微软官方）：核心插件，提供语法高亮、智能提示、运行调试、解释器管理等功能。
Pylance（微软官方）：Python 语言服务器，增强语法提示、类型检查、代码导航，建议搭配 Python 插件使用。
可选推荐插件（提升开发效率）
Code Runner：一键运行代码，右键即可执行，简化操作。
Black：代码格式化工具，自动排版，遵循 PEP8 编码规范。
Flake8：代码语法检查，提示语法错误与不规范写法。
GitLens：Git 版本控制增强工具，适合代码版本管理场景。
2. 配置 Python 解释器（关键）
VS Code 必须指定已安装的 Python 解释器，否则无法正常运行代码：
新建并打开后缀为
.py的 Python 文件。方式一：点击右下角状态栏的「Python x.x.x / 未选择解释器」，在弹出列表中选择已安装的 Python 版本。
方式二：快捷键
Ctrl+Shift+P（macOS：Cmd+Shift+P），输入Python: Select Interpreter，选择对应解释器。
⚠️ 注意
Windows 多版本共存时，优先选择 Python3.x 版本，避免使用 Python2。
列表未找到目标解释器：选择
Enter interpreter path，手动浏览选中 Python 可执行文件路径
Windows 示例：
C:\Program Files\Python311\python.exemacOS 示例：
/usr/local/bin/python3
3. 运行 Python 代码（3 种方式）
配置完成后，可通过以下三种方式运行代码：
方式 1：右键运行（Code Runner 插件）
安装 Code Runner 后，在代码编辑区右键，选择 Run Code，运行结果展示在下方「输出」面板。
方式 2：终端运行（原生方式）
打开 VS Code 终端（快捷键 `Ctrl+ ``），确保终端目录与代码文件所在目录一致。
执行命令运行代码：
python test.py # Windows 系统
python3 test.py # macOS / Linux 系统
方式 3：调试模式（断点调试）
适用于代码排错、逻辑排查：
点击代码行号左侧添加断点（出现红色圆点）。
按下
F5启动调试，首次调试依次选择「Python」→「Python 文件：当前文件」。调试快捷键：继续
F5、单步跳过F10、单步进入F11、结束调试Shift+F5，变量信息可在左侧「运行和调试」面板查看。
4. 配置代码格式化（可选，推荐）
使用 Black 实现代码自动格式化，统一代码风格：
- 终端执行命令安装 Black 工具：
pip install black
VS Code 配置自动格式化
快捷键
Ctrl+,打开设置，搜索Format On Save并勾选（保存文件自动格式化）。搜索
Python > Formatting: Provider，选择black作为默认格式化工具。
⚠️ 若提示「Black 未找到」
Windows 终端执行：
where black；macOS/Linux 终端执行：which black，复制工具完整路径。设置中搜索
Python > Formatting: Black Path，粘贴刚刚复制的路径即可。
5. 解决常见问题
提示「python 不是内部或外部命令」：安装 Python 时未勾选
Add Python to PATH，手动配置系统环境变量即可。解释器列表无目标版本：手动指定解释器路径，或重新安装 Python 并勾选环境变量选项。
调试无法进入函数：调试时使用
F11（单步进入），不要使用F10（单步跳过）。Black 格式化失败：执行
pip list检查是否成功安装 Black，或核对工具路径配置是否正确。
三、最终验证
新建 test.py 文件，写入以下测试代码：
def add(a, b):
return a + b
if __name__ == "__main__":
x = 10
y = 20
print(f"10 + 20 = {add(x, y)}")
按
F5调试：断点正常暂停，左侧面板可查看变量x=10、y=20。保存文件：已配置 Black 则代码自动完成格式化。
运行结果：终端/输出面板打印
10 + 20 = 30，代表环境配置全部成功。
按照以上步骤即可搭建完整的 Python 开发环境，满足日常编程、调试、代码格式化需求，可根据自身需求额外安装 Jupyter 等拓展插件。
