# VS Code 中 Python 开发环境的配置指南

### VS Code 中 Python 开发环境的配置指南

在 VS Code 中配置 Python 开发环境是入门 Python 的关键步骤，以下是完整、简洁的配置指南（适用于 Windows/macOS/Linux），包含核心插件、解释器配置、运行调试、代码格式化等核心功能：

## 一、前置准备：安装 Python 解释器

VS Code 本身不自带 Python 解释器，需先单独安装：

1.  下载 Python 官网地址：https://www.python.org/downloads/
    

*   Windows：勾选 `Add Python to PATH`（自动添加环境变量，关键！），然后默认安装。
    
*   macOS/Linux：系统自带 Python2，需额外安装 Python3
    
    *   macOS：`brew install python3`
        
    *   Ubuntu：`sudo apt install python3 python3-pip`
        

2.  验证安装 打开终端（Windows：cmd/PowerShell；macOS/Linux：Terminal），输入以下命令，能正常显示版本号即为安装成功：
    

```bash
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 解释器，否则无法正常运行代码：

1.  新建并打开后缀为 `.py` 的 Python 文件。
    
2.  方式一：点击右下角状态栏的「Python x.x.x / 未选择解释器」，在弹出列表中选择已安装的 Python 版本。
    
3.  方式二：快捷键 `Ctrl+Shift+P`（macOS：`Cmd+Shift+P`），输入 `Python: Select Interpreter`，选择对应解释器。
    

> ⚠️ 注意
> 
> 1.  Windows 多版本共存时，优先选择 Python3.x 版本，避免使用 Python2。
>     
> 2.  列表未找到目标解释器：选择 `Enter interpreter path`，手动浏览选中 Python 可执行文件路径
>     
>     *   Windows 示例：`C:\Program Files\Python311\python.exe`
>         
>     *   macOS 示例：`/usr/local/bin/python3`
>         

### 3\. 运行 Python 代码（3 种方式）

配置完成后，可通过以下三种方式运行代码：

#### 方式 1：右键运行（Code Runner 插件）

安装 Code Runner 后，在代码编辑区右键，选择 `Run Code`，运行结果展示在下方「输出」面板。

#### 方式 2：终端运行（原生方式）

1.  打开 VS Code 终端（快捷键 \`Ctrl+ \`\`），确保终端目录与代码文件所在目录一致。
    
2.  执行命令运行代码：
    

```bash
python test.py   # Windows 系统
python3 test.py  # macOS / Linux 系统
```

#### 方式 3：调试模式（断点调试）

适用于代码排错、逻辑排查：

1.  点击代码行号左侧添加**断点**（出现红色圆点）。
    
2.  按下 `F5` 启动调试，首次调试依次选择「Python」→「Python 文件：当前文件」。
    
3.  调试快捷键：继续 `F5`、单步跳过 `F10`、单步进入 `F11`、结束调试 `Shift+F5`，变量信息可在左侧「运行和调试」面板查看。
    

### 4\. 配置代码格式化（可选，推荐）

使用 Black 实现代码自动格式化，统一代码风格：

1.  终端执行命令安装 Black 工具：
    

```bash
pip install black
```

2.  VS Code 配置自动格式化
    
    *   快捷键 `Ctrl+,` 打开设置，搜索 `Format On Save` 并勾选（保存文件自动格式化）。
        
    *   搜索 `Python > Formatting: Provider`，选择 `black` 作为默认格式化工具。
        

> ⚠️ 若提示「Black 未找到」
> 
> 1.  Windows 终端执行：`where black`；macOS/Linux 终端执行：`which black`，复制工具完整路径。
>     
> 2.  设置中搜索 `Python > Formatting: Black Path`，粘贴刚刚复制的路径即可。
>     

### 5\. 解决常见问题

1.  **提示「python 不是内部或外部命令」**：安装 Python 时未勾选 `Add Python to PATH`，手动配置系统环境变量即可。
    
2.  **解释器列表无目标版本**：手动指定解释器路径，或重新安装 Python 并勾选环境变量选项。
    
3.  **调试无法进入函数**：调试时使用 `F11`（单步进入），不要使用 `F10`（单步跳过）。
    
4.  **Black 格式化失败**：执行 `pip list` 检查是否成功安装 Black，或核对工具路径配置是否正确。
    

## 三、最终验证

新建 `test.py` 文件，写入以下测试代码：

```python
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 等拓展插件。