VS Code 配置 Python 开发环境：从插件安装到运行第一个脚本
配置 Visual Studio Code（简称 VS Code）进行 Python 开发，核心路径仅有清晰的四步：确认本机存在 Python 解释器、在 VS Code 中安装官方 Python 扩展、指定项目所用的 Python 解释器版本，以及在工作目录中创建并执行脚本。掌握这套标准的配置逻辑，不仅能顺利完成首次代码运行，还能避免后续开发中频繁出现的“找不到模块”或“解释器无法识别”等常见问题。
一、认识核心角色：编辑器与解释器的关系
许多初学者容易产生一个误区，以为安装了 VS Code 及其 Python 扩展就直接拥有了 Python 运行环境。实际上，VS Code 本身仅是一个轻量级且高度可扩展的代码编辑器，它并不自带 Python 语言的执行引擎。
在整个工作流中，计算机本地安装的 Python（解释器可执行文件，如 python.exe 或 python3）负责实际编译与运行代码；而 VS Code 及其 Python 扩展则充当桥梁，负责提供语法高亮、代码补全、错误提示，并在接收到运行指令时，自动调用底层系统所安装的 Python 解释器来处理代码。
二、准备工作：验证本地 Python 环境
在打开 VS Code 之前，首先应在操作系统的终端中确认 Python 是否已正确安装且已加入系统环境变量 PATH 中。
打开系统终端（Windows 可使用 PowerShell，macOS 或 Linux 使用 Terminal），输入以下命令检查版本号：
python --version
# 若返回 command not found，可尝试检查 python3：
python3 --version示例输出：
Python 3.11.8三、关键配置步骤：从插件安装到选择解释器
完成环境确认后，启动 VS Code，依次完成插件获取与环境关联。整个配置流程可以总结为四个有序递进的步骤：
1. 安装官方 Python 扩展
点击 VS Code 左侧活动栏的“扩展”图标（快捷键 Ctrl+Shift+X 或 macOS 下的 Cmd+Shift+X），在搜索框中键入 Python。
在搜索结果列表顶部，找到由 Microsoft 官方发布的“Python”扩展并点击“安装”（Install）。安装该插件时，VS Code 会一并自动安装 Pylance 扩展，它负责提供高质量的代码智能补全、类型推断与实时语法高亮检查。
2. 打开工作目录
建议养成在独立工程目录中编写代码的习惯，而不是直接打开单个临时文件。点击顶部菜单的“文件” -> “打开文件夹...”，选择一个专门存放代码的本地空目录（例如 ~/workspace/python-demo）。打开文件夹后，VS Code 会将该目录作为工作区根节点，后续所有关于解释器的绑定和调试配置文件都将在此目录下生效。
3. 指定项目 Python 解释器
打开工作区后，必须告知 VS Code 当前项目使用哪个具体的 Python 解释器。操作方法如下：
- 使用快捷键
Ctrl+Shift+P（macOS 为Cmd+Shift+P）调出顶部命令面板。 - 在输入框中输入
Python: Select Interpreter并按回车。 - 列表中将列出系统已发现的所有可用 Python 解释器。选择标注有
Recommended或已安装目标版本的条目（例如Python 3.11.x 64-bit）。
完成选择后，观察 VS Code 最底部状态栏的右下方，若显示出对应的 Python 版本号，即表示当前工作区已成功绑定解释器。
四、编写与运行第一个 Python 脚本
完成环境配置后，即可在资源管理器中新建文件并执行测试。
1. 创建脚本文件
在左侧“资源管理器”视图中，点击新建文件图标，命名为 app.py，并在编辑器中输入以下标准测试代码：
import sys
def main():
greeting = "Hello, Python in VS Code!"
print(greeting)
print(f"当前运行 Python 版本: {sys.version.split()[0]}")
print(f"解释器执行路径: {sys.executable}")
if __name__ == "__main__":
main()2. 执行脚本与查看结果
保存文件（Ctrl+S 或 Cmd+S）后，点击编辑器右上角醒目的三角形“运行”按钮（Run Python File）。此时 VS Code 会在底部自动唤起内置终端，并在终端内生成执行指令并输出运行结果。
终端示例输出：
Hello, Python in VS Code!
当前运行 Python 版本: 3.11.8
解释器执行路径: /usr/local/bin/python3看到上述输出，即证明代码已经由预期的 Python 解释器执行完毕。
五、深度解析：界面直接运行与终端命令运行的差异
在日常使用中，开发者主要通过两种途径执行脚本：一是直接点击右上角的“三角形运行图标”；二是在底部的集成终端中手动输入 python app.py。理解这两种执行方式的关键差异，有助于在项目变复杂时准确排查路径和依赖问题。
| 对比维度 | 右上角一键运行 (Run File) | 集成终端手动命令 (CLI) |
|---|---|---|
| 解释器来源 | 严格使用 Select Interpreter 选定的路径 |
取决于当前终端进程的环境变量 PATH |
| 工作目录 (CWD) | 默认通常为当前打开的根文件夹 | 取决于当前终端 cd 所在的实际目录 |
| 适用场景 | 快速验证语法、单文件运行、日常脚本测试 | 运行带参数脚本（如 --mode test）、执行包测试 |
六、常见问题排查与速查清单
在配置过程中若遇到意外状况，可依照下列典型表现进行排查：
- 问题一：点击运行后提示“无法识别 python 命令”
原因及解决：说明终端会话中未加载系统 PATH。在 Windows 下可通过重新安装 Python 并务必勾选“Add python.exe to PATH”，或手动在系统属性中添加环境变量后彻底重启 VS Code。 - 问题二：代码中有红波浪线提示 ModuleNotFoundError，但代码能跑通
原因及解决：Pylance 语法分析器使用的解释器与实际运行代码的解释器不一致。重新通过Ctrl+Shift+P执行Python: Select Interpreter，切换到已经安装该模块的正确虚拟环境或全局环境中。 - 问题三：右下角状态栏不显示 Python 版本
原因及解决：VS Code 只有在当前打开的文件扩展名为.py，或者工作区中检测到 Python 文件时才会激活 Python 语言插件。打开任一.py文件后状态栏即可正常出现。
七、总结
VS Code 具备轻量与高扩展性的特点，在 Python 开发场景中，其本质是通过官方扩展将本地已经存在的 Python 解释器接入编辑器的生态中。只要按照“准备解释器 -> 安装扩展 -> 打开工程目录 -> 选择解释器路径”的标准逻辑推进，就能建立起稳定可靠的开发基石，为后续编写自动化脚本、数据处理或 Web 应用奠定良好的开端。
本站声明
本文内容仅供参考，不代表本站观点。转载或引用请注明出处。如发现内容问题，请通过联系我们页面反馈。
