必须用工作区级 settings.json 和 launch.json 分离语言行为，不能依赖全局设置；需为 Node.js 显式配置 "type": "node"、区分 name、设置 cwd，并按语言定制 tabSize、ESLint/Prettier 作用域及 node 路径。
Node.js 环境在 VSCode 中不是“单独配置完就一劳永逸”的事，它必须和 Python、Go、TypeScript 等其他语言共存于同一工作区时，才真正体现多语言集成的价值——但默认配置会互相干扰，比如缩进、格式化、调试入口冲突。核心结论：必须用工作区级 settings.json 和 launch.json 分离语言行为，不能依赖全局设置。
如何避免 Node.js 调试启动时误跑 Python 或 Go 脚本
VSCode 启动调试时只看 launch.json 里的 "type" 字段，但它不会自动过滤文件类型。常见错误是：你在 app.js 里按 F5，结果弹出提示“找不到 Python 解释器”，说明 VSCode 错拿了 Python 的调试配置。
- 确保每个语言的调试配置显式指定
"type"，且名称不重叠 - 在
launch.json的configurations数组中，为 Node.js 配置明确写死"type": "node"，不要省略或写成"nodejs"（后者无效） - 添加
"cwd": "${workspaceFolder}"，防止因终端路径错乱导致模块解析失败 - 如果项目含多个服务（如 Node.js API + Python worker），用
"name"区分，例如"name": "API Server (Node.js)"和"name": "Worker (Python)"
为什么 editor.tabSize 在多语言项目里必须分语言设置
全局设 "editor.tabSize": 2 对 JavaScript/TypeScript 友好，但会破坏 Python 的 PEP 8 规范（要求 4 空格）。直接改全局会导致 Python 文件缩进报错、IndentationError，而 Go 默认也是 4 空格。
- 在工作区
.vscode/settings.json中使用语言特异性配置块：{ "editor.tabSize": 2, "[javascript]": { "editor.tabSize": 2 }, "[typescript]": { "editor.tabSize": 2 }, "[python]": { "editor.tabSize": 4 }, "[go]": { "editor.tabSize": 4 } } - 不要用
"files.associations"把.js映射成typescript，否则eslint规则可能不生效 - 注意：语言 ID 必须准确，比如是
[python]，不是[py]或[Python]（大小写敏感）
Node.js 扩展与 ESLint/Prettier 如何不跟其他语言的 Linter 冲突
ESLint 和 Prettier 默认只对 .js、.ts 生效，但一旦你在根目录放了 .eslintrc.js，而项目里又有 Python 文件，VSCode 可能尝试对 .py 文件调用 ESLint，报错 Cannot find module 'eslint-plugin-python'。
- 在
settings.json中限定 ESLint 作用范围："eslint.validate": ["javascript", "typescript", "javascriptreact"] - 关闭非 JS/TS 语言的 ESLint 自动检查：
"eslint.enable": false放在[python]块内 -
Prettier同理，用"prettier.requireConfig": true，确保它只在有.prettierrc的子目录下工作，避免跨语言误格式化
为什么 nodejs.npmPath 不能写死在用户 settings.json 里
你用 Nodist 或 fnm 管理多版本 Node.js，但把 "nodejs.npmPath": "C:\Nodist\bin\npm.cmd" 写进全局 settings.json，会导致打开纯 Python 工作区时，VSCode 仍尝试加载 npm，拖慢启动速度，甚至触发权限警告。
- 这个配置只应在需要 Node.js 的工作区里出现，且应放在
.vscode/settings.json中 - 更稳妥的做法是：不设
nodejs.npmPath，而是确保终端启动时已由 shell 初始化了正确的PATH（比如通过fnm use或nvm use） - VSCode 集成终端默认继承系统 PATH，只要你在终端里能运行
npm -v，编辑器就能识别，无需额外配置
真正容易被忽略的是：launch.json 和 tasks.json 里的 ${workspaceFolder} 不会自动适配子目录中的语言服务。比如你的 Node.js 服务在 ./backend，Python worker 在 ./worker，那么调试配置必须显式指向子路径，不能只靠根目录的 settings.json 推导。
