VSCode 配置 Python 开发环境需正确安装官方 Python 扩展、选择匹配的解释器路径、配置 launch.json 的 cwd 和 args 参数、启用单一 linter（如 flake8）与 black 格式化，并统一集成终端 shell 环境。
VSCode 本身不是 Python IDE，但装对扩展、配好解释器、设好调试参数，它比很多专用 IDE 更轻快可控。关键不在“怎么装”，而在“哪些配置漏了会导致后续踩坑”。
安装 Python 扩展和确认解释器路径
只装 Python 官方扩展（Microsoft 出品）就够了，别叠加装 Pylance（它已集成进新版 Python 扩展）。装完后按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Python: Select Interpreter，从列表里选你实际要用的 Python 环境——比如 /usr/bin/python3、~/miniconda3/envs/myenv/bin/python，或 Windows 下的 C:\Users\name\Anaconda3\envs\py39\python.exe。
常见错误：选了系统自带的 python（如 macOS 的 /usr/bin/python），结果 pip install 装包不生效；或者没选中虚拟环境里的 python，导致 import 报错 ModuleNotFoundError。
- 用
which python（macOS/Linux）或where python（Windows）确认终端里当前生效的解释器路径，和 VSCode 里选的一致 - 如果解释器列表为空，先在终端运行
python -m pip install --upgrade pip，再重载窗口（Ctrl+Shift+P→Developer: Reload Window）
配置 launch.json 调试参数
调试 Python 不靠“运行按钮”，而靠 .vscode/launch.json。按 Ctrl+Shift+D 打开调试面板，点齿轮图标生成该文件。默认模板里最常用的是 Python File 和 Python Module 两种配置：
立即学习“Python免费学习笔记（深入）”；
-
"request": "launch"+"module": "http.server"适合调试命令行模块（如python -m http.server） -
"request": "launch"+"program": "${file}"是默认单文件调试，但注意：如果脚本依赖同目录下其他模块，需确保工作目录正确——加"cwd": "${fileDirname}" - 想传命令行参数？在
"args"字段写数组，比如"args": ["--verbose", "config.yaml"]
漏掉 "cwd" 或 "args" 是调试时找不到配置文件、参数不生效的主因。
启用 linting 和格式化（可选但强烈建议）
默认只开 flake8 或 pylint 之一即可，别同时开多个 linter，否则报错互相打架。在设置里搜 python.linting.enabled 开启，再设 python.linting.flake8Enabled 为 true（或对应 linter）。
格式化推荐 black：先 pip install black，然后在设置里设 python.formatting.provider 为 black，并确保 python.formatting.blackArgs 是空数组（避免传错参数导致格式化失败）。
- 若保存后没自动格式化，检查
editor.formatOnSave是否为true -
black不兼容 Python 3.6 以下语法，老项目慎用
终端里 Python 版本和 VSCode 不一致？
这是最隐蔽也最常被忽略的问题：VSCode 集成终端（Ctrl+`）启动时，可能没加载你的 shell 配置（如 ~/.zshrc），导致 python --version 显示系统默认版本，而你调试时却用的是虚拟环境。
解决方法是让 VSCode 终端复用你的 shell 初始化逻辑：
- macOS：在设置里搜
terminal.integrated.defaultProfile.osx，设为zsh或bash（看你用哪个） - Windows：设
terminal.integrated.defaultProfile.windows为PowerShell或Command Prompt，并确保python命令能被识别（可通过修改PATH或用py -3.9这类 launcher）
改完后关掉所有终端再新开，which python 和 python --version 就会和调试器对齐了。
