如何在VSCode中配置Python开发环境-VSCode-PHP中文网

选对Python解释器并统一配置路径才能确保VSCode正常运行：需通过命令面板选择明确路径的解释器，配置python.defaultInterpreterPath固化路径，launch.json中指定相同python字段，启用Pylance并排除干扰文件。

如何在vscode中配置python开发环境

选对 Python 解释器，`python` 命令才不会指向错的版本

VSCode 本身不自带 Python，它靠你本地装的解释器干活。如果你机器上同时有系统自带的 python3.9、pyenv 管理的 3.11、还有 Conda 环境里的 3.12，VSCode 默认可能随便挑一个——结果就是 import torch 报错，但终端里明明能跑。

实操建议：

按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（Mac），输入 Python: Select Interpreter，从列表里选带明确路径的项，比如 ./venv/bin/python 或 ~/miniconda3/envs/myproj/bin/python
别只认“Python 3.12”，要确认路径是否对应你的项目虚拟环境；点进去看右下角状态栏，显示的路径必须和你在终端里 which python 输出一致
如果列表为空，说明 VSCode 没扫描到解释器：检查是否装了 python 可执行文件，且在 $PATH 中；macOS 用户注意，/usr/bin/python3 是系统自带，不建议用于开发

`settings.json` 里配 `python.defaultInterpreterPath` 才算真正固化

光在 UI 里选一次解释器，只对当前工作区生效。关掉再打开，或者换个项目，又得重选。真正想“一劳永逸”，得写进配置。

实操建议：

打开命令面板，搜 Preferences: Open Settings (JSON)，编辑 settings.json
加这一行："python.defaultInterpreterPath": "./venv/bin/python"（Linux/macOS）或 "python.defaultInterpreterPath": ".\venv\Scripts\python.exe"（Windows）
路径必须是相对当前工作区根目录的，不能用 ~ 或 $HOME；绝对路径虽然能用，但换机器就失效
如果项目用 Conda，路径类似 "/opt/anaconda3/envs/myenv/bin/python"，记得确认该环境已创建且未被删除

调试时 `launch.json` 不配 `python` 路径，断点直接失效

即使解释器选对了，VSCode 调试器（Debugger）默认仍可能调用系统 python，导致断点不命中、变量看不到、甚至报 ModuleNotFoundError。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

实操建议：

在项目根目录建 .vscode/launch.json，确保 configurations 下有 "python" 字段，例如：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python: Current File",
      "type": "python",
      "request": "launch",
      "module": "pytest",
      "console": "integratedTerminal",
      "justMyCode": true,
      "python": "./venv/bin/python"
    }
  ]
}

"python" 字段值必须和 python.defaultInterpreterPath 一致；漏写或写成 "pythonPath"（旧版字段）会导致配置被忽略
如果用 pytest 或 flask run 启动，"module" 和 "args" 要配对，否则调试器启动后立刻退出

Pylance 和 Python 扩展不是一回事，关掉 Pylance 就等于放弃类型提示

很多人装了 Python 扩展就以为万事大吉，其实核心语言支持（跳转、补全、类型推导）靠的是 Pylance——它是独立扩展，可开关，且默认启用。关了它，str. 后面几乎没补全，def foo(x: int) 的类型检查也停摆。

实操建议：

检查扩展面板里 Pylance 是否已安装并启用；如果禁用了，重启 VSCode 后类型提示不会自动恢复
若提示“no stubs found”或补全卡顿，去 settings.json 加："python.analysis.extraPaths": ["./src"]，把自定义模块路径告诉 Pylance
不要为了“快一点”关 Pylance——现代机器上它的内存占用可控；真卡顿优先查是不是 __pycache__ 或大日志文件被误纳入索引（用 python.analysis.exclude 排除）

VSCode 的 Python 配置不是“设一次就完事”，解释器路径、调试器路径、语言服务器路径三者必须严格对齐，差一个字符都可能让 import 失败或断点失灵。最常被忽略的是：改了 settings.json 后没重启窗口，或改了 launch.json 却没切回正确的 launch configuration。