多根工作区是必须启用的起点，需通过“添加文件夹到工作区”后另存为.code-workspace文件实现；各子文件夹独立配置.vscode/settings.json和launch.json，语言设置用[language]块锁定，终端需右键打开对应目录，任务须显式指定cwd。
多根工作区不是可选，是必须启用的起点
如果你把前端、后端、脚本目录全塞进一个文件夹再开 VSCode，后续所有语言配置都会互相污染。VSCode 的 settings.json 按文件夹层级生效，单根工作区下无法为 src/frontend 和 src/backend 设置互不干扰的缩进、格式化器或 ESLint 规则。
正确做法是：打开空 VSCode → “文件” → “添加文件夹到工作区” → 分别加入 frontend/、backend/、scripts/；然后“文件” → “将工作区另存为…” → 生成 myproject.code-workspace。这个文件会记录每个文件夹的路径和独立配置入口。
- 每个子文件夹下的
.vscode/settings.json只影响该文件夹内文件，比如backend/.vscode/settings.json设"python.defaultInterpreterPath"不会影响frontend/里的 TypeScript - 不要在根目录（即
.code-workspace同级）放.vscode/settings.json，它会被所有子文件夹继承，反而破坏隔离 - 如果某项设置需全局生效（如字体大小），改用户设置（
Ctrl+,→ 右上角切换到 “用户”），而非工作区设置
语言扩展装对了，但没配对等于白装
装了 ms-python.python、esbenp.prettier-vscode、golang.go 这些扩展只是第一步。它们默认行为往往冲突——比如 Prettier 和 Black 都想格式化 .py 文件，结果保存时反复打架。
关键在 .vscode/settings.json 里用语言专属块锁定行为：
- 在
backend/.vscode/settings.json中写：{ "[python]": { "editor.defaultFormatter": "ms-python.black-formatter", "editor.formatOnSave": true } } - 在
frontend/.vscode/settings.json中写：{ "[typescript]": { "editor.defaultFormatter": "esbenp.prettier-vscode", "editor.formatOnSave": true } } - 切记：语言标识符必须用方括号包裹，且严格匹配 VSCode 内置语言 ID（
[javascript]、[json]、[shellscript]，不是文件扩展名）
调试配置别堆在一个 launch.json 里
很多人把 Node.js、Python、Go 的调试配置全塞进同一个 .vscode/launch.json，结果启动时 VSCode 提示 “无法识别 type: python”，或者断点根本不起作用——因为不同语言调试器依赖不同扩展，而 launch.json 不会自动加载对应扩展。
更稳妥的做法是按子项目拆分：
- 在
frontend/.vscode/launch.json中只保留"type": "pwa-node"或"type": "chrome"配置，确保ms-vscode.vscode-typescript-next已启用 - 在
backend/.vscode/launch.json中只保留"type": "python"配置，并确认python.defaultInterpreterPath指向正确的虚拟环境 - 如果需要同时启动前后端（比如前端调用后端 API），用
compound配置，但前提是两个子文件夹各自的launch.json都已单独验证通过
终端和任务别指望自动识别上下文
VSCode 内置终端默认不感知你当前在哪个子文件夹里编辑。你在 backend/ 里按 Ctrl+` 打开终端，pwd 却可能是工作区根目录，pip install 装错地方、npm run dev 报 package.json not found 是常态。
解决方法很直接：
- 右键点击资源管理器中的某个子文件夹 → “在集成终端中打开”，终端会自动 cd 进该路径
- 为每个子文件夹定义专属
tasks.json，例如backend/.vscode/tasks.json中指定"cwd": "${workspaceFolder}/backend" - 避免用全局任务（如
shell.command），所有命令路径都用${workspaceFolder}或${fileDirname}显式声明
混合开发真正卡住人的，从来不是插件装不装得上，而是路径、作用域、执行上下文这三样东西没对齐。一旦子文件夹的 .vscode 目录各自独立、各自精准，多语言就不再“混合”，而是“并存”。
