VSCode中Python配置分散在多个文件：settings.json管编辑格式化，launch.json管调试行为，tasks.json管构建任务，pyproject.toml或.python-version定义项目Python版本契约。
VSCode 里 Python 相关配置不是靠一个文件“一劳永逸”，而是分散在 settings.json、launch.json、tasks.json 和项目根目录的 .python-version 或 pyproject.toml 中，各自承担不同职责。搞混它们的用途，轻则调试失败，重则解释器识别错乱、格式化失效。
settings.json 控制编辑与格式化行为
这是你日常编码体验最直接的控制层，影响语法高亮、自动补全、格式化触发时机等。它不决定“用哪个 Python 解释器运行”，只决定“怎么写、怎么显示”。
-
"python.defaultInterpreterPath"不推荐在这里硬编码路径——它会被Python: Select Interpreter命令覆盖，且无法感知虚拟环境激活状态 - 真正该配的是格式化工具：比如用
black就设"python.formatting.provider": "black"；用autopep8则对应"autopep8" - 启用保存时自动格式化：
"editor.formatOnSave": true，但建议同时加"[python]": { "editor.formatOnSave": true }，避免影响其他语言文件 - 关闭烦人的括号自动补全（很多人误以为是 Python 插件问题）：
"editor.autoClosingBrackets": "never"或仅对 Python 关闭："[python]": { "editor.autoClosingBrackets": "never" }
launch.json 管理调试行为而非运行环境
这个文件只在按 F5 启动调试器时生效，它不控制终端里 python script.py 的执行逻辑，也不影响 pip install 的目标环境。
-
"python"类型的调试配置中，"python"字段必须指向当前项目实际使用的解释器路径（比如./venv/bin/python），不能写成python或python3—— 否则会 fallback 到系统默认，绕过虚拟环境 -
"console": "integratedTerminal"是刚需，否则输出进 debug console，无法交互输入 -
"justMyCode": true必须开启，否则单步调试时疯狂跳进requests、numpy源码，毫无意义 - 不要在
launch.json里写"env"来模拟pip install的环境变量——那是tasks.json或终端的事
tasks.json 处理构建与包管理任务
当你需要一键运行 pip install -r requirements.txt、执行 pytest 或生成文档时，tasks.json 是唯一正解。它本质是 VS Code 对 shell 命令的封装和复用机制。
立即学习“Python免费学习笔记（深入）”；
- 关键字段是
"type": "shell"和"command"，例如："command": "${command:python.interpreterPath}"可动态获取当前选中的解释器路径，比写死路径更可靠 - 如果任务要激活虚拟环境，Windows 下用
".\venv\Scripts\activate.bat && pip install -r requirements.txt"，macOS/Linux 用"source venv/bin/activate && pip install -r requirements.txt" - 注意
"group": "build"或"group": "test"，这样 Ctrl+Shift+P → “Tasks: Run Build Task” 才能分类调用 - 别把
tasks.json当成启动脚本——它不持久，每次执行都是新 shell，没法维持activate状态
pyproject.toml 或 .python-version 定义项目级 Python 版本契约
这两个文件才是告诉团队“这个项目必须用 Python 3.11”的权威声明，VS Code 的 Python 扩展会读取它们来推荐解释器，但不会强制切换。
-
.python-version（由 pyenv 使用）内容就是纯文本，如3.11.9，简单直接，VS Code + Python 插件能识别 -
pyproject.toml更现代，需在[tool.poetry.dependencies]或[project]下声明：requires-python = ">=3.11,，插件据此过滤解释器列表 - 两者都放在项目根目录，且应提交到 Git —— 这是项目可重现性的基础设施，不是个人偏好设置
- 如果你没看到 VS Code 自动提示匹配的解释器，先检查是否安装了对应版本的 Python，再确认文件名拼写和位置是否正确（尤其注意
.python-version开头的点不能丢）
最容易被忽略的是：VS Code 的 Python 插件不会自动 reload pyproject.toml 修改后的解释器推荐，改完得手动触发 Python: Select Interpreter，或者关掉再打开文件夹。配置文件之间没有自动联动，靠人脑对齐职责边界。
