VSCode 中配置并运行 Python 代码的核心步骤是：确保系统已安装 Python，为 VSCode 安装 Python 扩展，配置 Python 解释器，设置必要的开发辅助工具（如代码检查、格式化），最后利用内置的调试和运行功能执行代码。整个过程以创建一个简单项目并运行 `Hello World` 为例展开，具体操作步骤与配置要点如下表所示 [ref_1][ref_3]： | 步骤 | 核心操作 | 关键配置/说明 | 参考资料 | | :--- | :--- | :--- | :--- | | **1. 环境准备** | 安装 Python 和 VSCode | 安装 Python 时务必勾选 “Add Python to PATH”，以便在终端直接调用。VSCode 从官网下载安装。 | [ref_1][ref_4] | | **2. 安装扩展** | 安装官方 Python 扩展 | 在 VSCode 扩展市场中搜索并安装 “Python”，由 Microsoft 提供，包含运行、调试、智能感知等核心功能。 | [ref_1][ref_3] | | **3. 创建项目** | 新建文件夹并用 VSCode 打开 | 所有 Python 文件应在一个项目文件夹中，通过 `File > Open Folder` 打开以激活扩展。 | [ref_3][ref_4] | | **4. 配置解释器** | 选择 Python 解释器 | 使用快捷键 `Ctrl+Shift+P`，输入 “Python: Select Interpreter”，选择系统或虚拟环境（如 Anaconda）下的 Python 路径。 | [ref_1][ref_3][ref_5] | | **5. 辅助工具** | 安装代码检查与格式化工具 | 在 VSCode 的集成终端中，使用 `pip` 安装 `flake8`（代码检查）和 `yapf`（格式化）。 | [ref_4][ref_6] | | **6. 运行与调试** | 编写并执行 Python 代码 | 创建 `.py` 文件后，可直接右键选择 “Run Python File in Terminal”，或使用 `F5` 进行调试运行。 | [ref_1][ref_3][ref_4] | 以下是每个步骤的详细说明与具体操作示例。 ### 1. 安装 Python 与 VSCode 首先，需要在操作系统中安装 Python。访问 [Python 官方网站](https://www.python.org/downloads/) 下载安装程序。在安装向导中，**必须勾选 “Add Python to PATH” 选项**，这是为了让系统终端能识别 `python` 命令，VSCode 也依赖于此路径来定位解释器 [ref_4][ref_6]。安装完成后，可以在命令提示符（CMD）或 PowerShell 中输入 `python --version` 或 `python -V` 来验证安装是否成功。 VSCode 的安装相对直接，从官网下载安装程序即可 [ref_1]。 ### 2. 安装 Python 扩展 启动 VSCode 后，在左侧活动栏点击“扩展”图标（或按 `Ctrl+Shift+X`），在搜索框中输入 “Python”。找到由 Microsoft 发布的 “Python” 扩展，点击“安装”。这是 VSCode 支持 Python 开发最核心的插件，它提供了语法高亮、智能补全、代码导航、调试器、测试工具等全套功能 [ref_1][ref_3][ref_6]。 ```json // 示例：VSCode 中与 Python 扩展相关的基础工作区配置 (settings.json) // 此配置主要用于启用 flake8 和 yapf 工具 { "python.linting.enabled": true, "python.linting.flake8Enabled": true, "python.formatting.provider": "yapf", "editor.formatOnSave": true, "editor.codeActionsOnSave": { "source.fixAll": "explicit" } } ``` *代码片段展示了如何通过 VSCode 设置文件启用代码检查 (`flake8`) 和自动格式化 (`yapf`) 功能，这对提升代码质量至关重要 [ref_4][ref_6]。* ### 3. 创建并打开项目文件夹 Python 开发推荐使用项目制。首先在磁盘上创建一个新的文件夹，例如 `my_python_project`。然后打开 VSCode，通过菜单栏 `File > Open Folder...` 选择并打开该文件夹。这样，VSCode 会将此文件夹识别为工作区，其 Python 扩展才能在该上下文环境中生效 [ref_4]。 ### 4. 配置 Python 解释器 解释器是执行 Python 代码的核心。在 VSCode 中，可以通过命令面板快速选择。使用快捷键 `Ctrl+Shift+P` 打开命令面板，输入 “Python: Select Interpreter” 并选择该命令。随后，VSCode 会列出当前系统中所有可用的 Python 解释器，包括全局安装的 Python、Anaconda 环境中的 Python 等 [ref_3][ref_5]。选择一个解释器后，VSCode 会在项目根目录下自动生成一个 `.vscode/settings.json` 文件来保存此配置。 对于使用 Anaconda 管理虚拟环境的用户，配置路径指向 `conda` 环境的 Python 可执行文件是关键，有时还需要在 Windows 的环境变量中为 Bash 终端（如 Git Bash）添加 Anaconda 的路径，以确保终端环境与 VSCode 集成终端的统一 [ref_5]。 ### 5. 安装辅助开发工具（推荐） 为了获得更好的开发体验，建议安装 `flake8` 和 `yapf`。`flake8` 是一个代码规范检查工具，能帮你发现潜在的错误和不规范的代码风格；`yapf` 是 Google 开源的 Python 代码格式化工具。它们可以通过 `pip` 安装。在 VSCode 中，使用 `View > Terminal` 打开集成终端，然后运行以下命令进行安装： ```bash # 在 VSCode 的集成终端中安装代码检查与格式化工具 pip install flake8 yapf ``` 安装后，需要配置 VSCode 以启用它们。如前文 `settings.json` 示例所示，通过设置 `python.linting.flake8Enabled` 为 `true` 和 `python.formatting.provider` 为 `"yapf"`，可以激活这两项功能。设置 `editor.formatOnSave` 为 `true` 可以实现在保存文件时自动格式化代码，非常高效 [ref_4][ref_6]。 ### 6. 编写、运行与调试代码 完成以上配置后，就可以开始编写代码了。在 VSCode 的资源管理器（Explorer）中右键项目文件夹，选择 “New File”，创建一个名为 `hello.py` 的文件。输入经典的代码： ```python # 这是第一个Python程序，用于验证环境配置 print("Hello, World!") ``` 运行此文件有两种最直接的方式： 1. **直接运行**：在编辑器中右键点击，选择 **“Run Python File in Terminal”**。VSCode 会自动在底部面板打开终端，并执行 `python hello.py` 命令，你会立即看到输出结果 [ref_4]。 2. **调试运行**：按 `F5` 键，或者在左侧活动栏点击“运行与调试”图标（或按 `Ctrl+Shift+D`），然后点击绿色的开始按钮。首次调试需要创建一个调试配置。VSCode 通常会自动提示，选择 “Python File” 即可。这会在 `.vscode/` 文件夹下生成一个 `launch.json` 文件。调试模式允许你设置断点、单步执行、查看变量值，是排查复杂问题的利器 [ref_1][ref_3]。 对于希望更快捷运行单行或选中代码块的用户，还可以安装 `Code Runner` 扩展。安装后，右上角会出现一个“运行”三角形按钮，或者选中代码后右键选择 “Run Code”，也能快速执行 [ref_2][ref_6]。 综上所述，VSCode 配置 Python 环境是一个结构化的过程。通过安装核心扩展、配置正确的解释器、并辅以必要的代码质量工具，可以搭建出一个高效、功能强大的 Python 开发环境。