唯一可靠做法是用.code-workspace定义多根工作区，并为各子目录配置独立.vscode/settings.json实现语言级隔离；语言ID块无法区分同语言不同项目的路径、工具链及扩展开关差异，必须下沉至文件夹级配置。
直接用 .code-workspace 文件定义多根工作区，配合各子目录下的 .vscode/settings.json 实现语言级隔离——这是唯一能同时满足项目独立性、团队一致性与调试准确性的做法。硬塞所有配置进用户级 settings.json 或靠手动切换语言模式，迟早出问题。
为什么不能只靠“语言特定设置”块？
语言 ID 配置块（如 "[python]"）看似简洁，但它不绑定路径、不区分上下文。同一个 Python 文件在不同项目里可能需要：不同的解释器路径、不同的 black 版本、是否启用 pylint、甚至是否允许自动添加空行。这些都超出了纯编辑行为范畴，必须和项目位置强关联。
- 当多个 Python 项目共存时，
"[python]"块只能写一套值，无法适配backend/和scripts/的差异 -
"python.defaultInterpreterPath"这类路径型配置一旦写进全局或工作区根settings.json，就无法按子文件夹再细分 - 扩展启用状态（比如禁用 Prettier 对
.py文件的干扰）只能通过文件夹级settings.json控制，语言块做不到
如何正确组织 .vscode 目录结构？
关键不是“有没有”，而是“放在哪”——优先级链条是：文件夹级 > 工作区级 > 用户级。所有语言相关配置，只要涉及路径、工具链、扩展开关，一律下沉到对应子目录的 .vscode/settings.json 中。
-
my-project.code-workspace只负责声明根路径和工作区名称，不写任何语言配置 -
backend/.vscode/settings.json里放"python.defaultInterpreterPath": "./venv/bin/python"、"python.formatting.provider": "black" -
frontend/.vscode/settings.json里放"javascript.format.enable": true、"prettier.requireConfig": true - 避免在
my-project/.vscode/settings.json（即工作区根）里写语言配置，它会被子目录的同名文件覆盖，但容易误删或混淆
extensions.json 是团队环境对齐的关键
光有设置不够，新人打开项目第一件事就是缺扩展。VSCode 的 .vscode/extensions.json 能显式声明“这个工作区必须装哪些扩展”，比口头提醒或 README 更可靠。
- 它不安装扩展，只提示用户安装缺失项；点击提示即可跳转到扩展页
- 格式是纯 JSON，示例：
{ "recommendations": [ "ms-python.python", "esbenp.prettier-vscode", "rust-lang.rust-analyzer" ] } - 注意推荐列表必须用扩展 ID（不是名字），查 ID 最快方式：在扩展市场页 URL 里看最后一段，如
https://marketplace.visualstudio.com/items?itemName=ms-python.python→ ID 是ms-python.python - 不要把调试器扩展（如
ms-vscode.cpptools）和格式化扩展（如esbenp.prettier-vscode）混在同一个推荐列表里却不加说明——C++ 开发者不需要 Prettier 处理.cpp文件
容易被忽略的调试器路径陷阱
launch.json 里的 "program" 或 "module" 字段，不是写相对路径就完事。VSCode 启动调试器时，实际执行的是你本地终端能跑起来的命令，所以路径必须真实存在且权限正确。
- Python 调试中写
"module": "http.server"是对的，但若项目没装httpx或flask，运行时仍会报错——launch.json不检查依赖，只负责调用 - Go 调试必须确认
dlv在$PATH里，且版本兼容（dlv version输出需匹配 Go 版本），否则"type": "go"配置直接静默失败 - Rust 调试依赖系统级
lldb，macOS 自带，Linux 需sudo apt install lldb，Windows 必须装完整 LLVM，只下rust-analyzer二进制没用 - 所有调试器路径类配置（如
"cargo"、"dlv"、"lldb"）都不该写死绝对路径，而应确保它们在 shell 的$PATH中——VSCode 继承的是你终端启动时的环境变量
真正难的不是配置语法，而是让每种语言的工具链（LSP、格式化器、调试器）在各自文件夹里互不感知、各干各的。一旦某个 Python 扩展开始试图格式化 .ts 文件，或者某个 Rust LSP 因路径错误拖慢整个工作区启动，问题根源几乎都在配置层级混乱上。
