VS Code 配置 Python 开发环境教程

VS Code 是轻量且强大的代码编辑器，配合丰富的插件和灵活的配置，能打造高效的 Python 开发环境。本文从基础安装到进阶配置，一步步教你搭建适合自己的 Python 开发环境，全程以实操为主，覆盖新手常见需求。

一、前期准备

1. 安装 Python 解释器

  • 前往 Python 官网下载最新版 Python（推荐 3.8 及以上版本），安装时务必勾选「Add Python to PATH」（Windows 关键步骤，macOS/Linux 一般自动配置）。
  • 验证安装：打开系统终端（Windows 命令提示符/终端、macOS 终端），输入 python --version（Windows）或 python3 --version（macOS/Linux），能显示版本号即安装成功。

二、基础配置：安装核心插件

打开 VS Code，点击左侧边栏「扩展」图标（快捷键 Ctrl+Shift+X/Cmd+Shift+X），搜索并安装以下必备插件：

1. Python（官方插件）

微软官方出品，是 Python 开发的核心插件，提供语法高亮、代码补全、运行/调试、格式化等基础功能，安装量最高，直接点击「安装」即可。

2. Pylance（可选但推荐）

作为 Python 插件的增强工具，提供更智能的代码补全、类型检查、语义分析，安装后会自动关联 Python 插件，大幅提升编码体验。

3. Chinese (Simplified)（可选）

如果不习惯英文界面，安装该插件后重启 VS Code，即可切换为简体中文界面。

三、核心配置：关联 Python 解释器

VS Code 需明确使用哪个 Python 解释器，才能正确运行和调试代码，步骤如下：

  1. 打开 VS Code，新建一个文件夹（作为项目根目录），再新建一个 .py 文件（如 test.py）。
  2. 按下快捷键 Ctrl+Shift+P/Cmd+Shift+P，输入「Python: 选择解释器」（或中文界面「Python: 选择解释器」）。
  3. 在弹出的列表中，选择你安装的 Python 版本（比如 Python 3.11.x 64-bit）。如果列表中没有，点击「输入解释器路径」，手动找到 Python 安装目录下的 python.exe（Windows）或 python3（macOS/Linux）。
  4. 验证：在 test.py 中输入 print("Hello VS Code!")，右键点击编辑区，选择「在终端中运行Python文件」，终端输出对应内容即关联成功。

四、常用配置：自定义开发环境

通过修改 VS Code 的「设置」，可以适配个人开发习惯，以下是高频配置项：

1. 打开设置界面

  • 方式1：快捷键 Ctrl+,/Cmd+, 直接打开设置。
  • 方式2：点击左下角「设置」图标（齿轮形状），选择「设置」。

2. 关键配置项（搜索对应关键词修改）

（1）自动格式化代码

  • 搜索「Format On Save」，勾选「Editor: Format On Save」，保存文件时自动格式化代码。
  • 搜索「Python Formatting Provider」，选择格式化工具（推荐「autopep8」，需提前安装：终端输入 pip install autopep8）。

（2）修改终端类型（Windows 可选）

Windows 默认终端可能是「Command Prompt」，可改为 PowerShell 或 Git Bash：

  • 搜索「Terminal > Integrated: Default Profile: Windows」，选择「PowerShell」或「Git Bash」（需提前安装 Git）。

（3）设置代码缩进

  • 搜索「Tab Size」，设置值为 4（Python 规范缩进为 4 个空格）。
  • 勾选「Editor: Insert Spaces」，将制表符转换为空格，符合 Python 编码规范。

（4）显示行号

  • 搜索「Line Numbers」，选择「on」，默认已开启，确保代码左侧显示行号，方便调试。

3. 自定义配置文件（进阶）

VS Code 的设置会保存在 settings.json 文件中，可直接编辑该文件实现更精细的配置：

  1. 打开设置界面，点击右上角「打开设置（JSON）」图标（{} 形状）。
  2. 粘贴以下配置（按需修改），保存即可生效：
{
    "python.pythonPath": "你的Python解释器路径",
    "editor.formatOnSave": true,
    "python.formatting.provider": "autopep8",
    "editor.tabSize": 4,
    "editor.insertSpaces": true,
    "terminal.integrated.defaultProfile.windows": "PowerShell",
    "files.autoSave": "afterDelay",
    "python.analysis.autoImportCompletions": true
}

五、调试 Python 代码

VS Code 自带强大的调试功能，能逐行执行代码、查看变量值，是排查问题的核心工具：

  1. 打开需要调试的 .py 文件，点击左侧边栏「运行和调试」图标（虫子形状）。
  2. 点击「创建 launch.json 文件」，选择「Python」→「Python 文件」，自动生成调试配置文件。
  3. 在代码中需要暂停的行号左侧点击，添加「断点」（红色小圆点）。
  4. 点击顶部「运行」按钮（绿色三角形）或按 F5，程序会在断点处暂停。
  5. 调试工具栏操作：
    • 继续（F5）：运行到下一个断点；
    • 单步执行（F10）：逐行执行代码，不进入函数；
    • 单步进入（F11）：进入函数内部执行；
    • 监视：在「监视」面板输入变量名，实时查看变量值。

六、常用快捷键（提升效率）

快捷键 功能 系统
Ctrl+Shift+P/Cmd+Shift+P 打开命令面板 全平台
Ctrl+,/Cmd+, 打开设置 全平台
Ctrl+S/Cmd+S 保存文件 全平台
F5 启动调试 全平台
F10 调试单步执行 全平台
Ctrl+//Cmd+/ 注释/取消注释代码行 全平台
Alt+↑/Alt+↓ 上下移动代码行 全平台
Ctrl+Shift+K/Cmd+Shift+K 删除当前代码行 全平台
Ctrl+ `/Cmd+ ` 打开/关闭终端 全平台

七、常见问题解决

1. 终端提示「python 不是内部或外部命令」

原因：Python 未添加到系统 PATH，解决方法：

  • 重新安装 Python，勾选「Add Python to PATH」；
  • 手动配置 PATH：Windows 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，在「系统变量」的「Path」中添加 Python 安装路径（如 C:\Python311 和 C:\Python311\Scripts）。

2. 代码补全不生效

  • 确认已安装 Pylance 插件；
  • 重启 VS Code，或按下 Ctrl+Shift+P 输入「Python: 重启语言服务器」；
  • 检查是否关联了正确的 Python 解释器。

3. 格式化代码时报错

  • 确保已安装对应的格式化工具（如 autopep8、black），终端输入 pip install autopep8；
  • 在设置中确认「Python Formatting Provider」选择了对应的工具。

八、总结

VS Code 配置 Python 核心就三步：安装插件→关联解释器→自定义配置。新手先掌握基础的运行、调试功能，再根据自己的开发习惯调整快捷键和格式化规则。后续可根据需求安装更多插件（如 Python Docstring Generator 生成注释、GitLens 管理版本），逐步完善开发环境。

posted on 2025-11-26 14:00  小学生学IT  阅读(0)  评论(0)    收藏  举报

导航