答案：需在项目根目录创建标准locales结构并配置.i18n-allyrc.json，显式指定语言id和glob路径，否则i18n-ally无法识别翻译键；调试时须隔离launch.json中各语言的name和type，避免冲突。
VSCode 本身不提供 Node.js 运行时的多语言支持（比如让 console.log 自动翻译），它只负责编辑、调试和格式化代码；真正的国际化（i18n）必须由 Node.js 项目自身实现，而 VSCode 的角色是高效支撑这一流程——关键在于插件配置、文件结构和调试隔离。
如何用 i18n-ally 插件管理 Node.js 项目的 locales 文件
i18n-ally 是目前最稳定的 VSCode 国际化辅助工具，对 Node.js（如使用 i18next、node-i18n 或纯 JSON 翻译方案）支持良好，但默认不会自动识别任意目录下的翻译文件。
- 必须在项目根目录创建标准
locales结构，例如：/locales/en/common.json、/locales/zh-CN/common.json，不能放在src/i18n或config/translations这类自定义路径下（除非显式配置） - 安装插件后，立即在项目根目录添加
.i18n-allyrc.json，否则插件大概率“看不见”你的翻译键 - 配置中
"en"和"zh-CN"是语言 ID，不是文件夹名；如果用了zh或zh_CN，插件无法匹配，补全和缺失检测全部失效 - Node.js 项目常用
common.json+validation.json多文件拆分，需在.i18n-allyrc.json中用 glob 模式覆盖："en": "locales/en/**/*.json"
为什么 launch.json 里 Node.js 调试配置不能和 Python/Go 共用 name
VSCode 启动调试时，只看 launch.json 里的 "type" 字段决定用哪个调试器，但选择哪个配置项却依赖 "name" ——如果你有两个配置都叫 "Launch"，按下 F5 时它会随机选一个，极可能误启 Python 解释器跑 Node.js 文件，报错 ModuleNotFoundError: No module named 'app'。
- 每个语言的调试配置必须有唯一
"name"，推荐带运行时标识，例如："name": "API (Node.js)"、"name": "Worker (Python)" -
"type": "node"必须显式写出，不能省略或写成"nodejs"（后者会导致配置被忽略） - Node.js 配置中务必加
"cwd": "${workspaceFolder}"，否则require('./locales/en/common.json')可能因工作目录不对而Cannot find module - 如果项目含 TypeScript，不要直接调试
.ts文件；要么编译后调试dist/app.js，要么用"runtimeArgs": ["--loader", "ts-node/esm"]并确保已安装ts-node
如何避免 ESLint/Prettier 在 Node.js 项目中误扫 Python/Go 文件
ESLint 默认只处理 .js 和 .ts，但一旦你在项目根目录放了 .eslintrc.js，某些旧版 ESLint 扩展会尝试扫描所有文件，遇到 .py 就报 Cannot find module 'eslint-plugin-python' ——这不是插件装错了，而是作用域没锁死。
- 在工作区
.vscode/settings.json中强制限定 ESLint 仅作用于 JS/TS："eslint.validate": ["javascript", "typescript", "javascriptreact", "typescriptreact"] - 禁用全局
files.associations映射（比如把.js强制关联为typescript），这会导致eslint-plugin-node规则失效 - Prettier 同理：用
"prettier.disableLanguages": ["python", "go"]，而不是靠文件扩展名过滤（.py文件可能被误认为text.plain） - Node.js 项目若混用 ESM（
type: "module"），需在package.json中声明，否则import语句在调试时会触发ERR_REQUIRE_ESM
真正容易被忽略的点是：i18n-ally 的键补全只在打开的 JSON 文件中生效，且依赖你当前光标所在语言模式（即右下角显示的是 JSON，不是 JSON with Comments）；如果用了 .jsonc 格式又没配插件支持，补全和校验就全挂了。
