VS Code插件开发工具链（vsce、yo等）输出均为英文，无法本地化；activationEvents仅识别英文标识符，中文关键词无效；调试中文乱码需配置Node.js编码环境，项目路径建议全英文。
VS Code 插件开发本身不提供中文界面或中文文档工具链，所有官方 CLI 工具（如 vsce、yo、vscode-test）输出均为英文，但可通过配置和约定实现开发过程全程中文辅助。
vsce 命令行工具的中文错误提示适配
执行 vsce publish 失败时，终端报错永远是英文（如 Failed to verify package: Invalid publisher name），无法直接靠翻译理解问题根源。这不是 bug，而是工具链设计如此——vsce 依赖 npm 和 GitHub API 的原始响应，未做本地化封装。
- 遇到
Invalid version：检查package.json中version字段是否符合 semver 规范（如"1.0.0"，不能是"1.0"或"v1.0.0"） - 出现
Missing README.md：不是文件名大小写问题（Windows 下常误建为Readme.md），而是路径必须严格为根目录下的README.md -
Failed to fetch user info通常意味着 GitHub token 权限不足，需在Settings > Developer settings > Personal access tokens中勾选read:packages和delete:packages
调试插件时 console.log 输出中文乱码
在 extension.ts 中写 console.log("加载完成")，启动 Extension Development Host 后，调试控制台显示 字符——这并非 VS Code 问题，而是 Node.js 运行时默认编码未识别当前系统 locale。
- Windows 用户：在 launch.json 的
env中显式设置"NODE_OPTIONS": "--icu-data-dir=node_modules/full-icu"，并安装full-icu包 - macOS/Linux：确保终端 LANG 环境变量为
zh_CN.UTF-8（可通过echo $LANG验证），否则 Node.js 会 fallback 到 ASCII - 最简验证法：在调试控制台中执行
process.stdout.write('\u4f60\u597d')，若显示“你好”则编码正常；否则问题出在运行时环境，非插件代码
package.json 的 activationEvents 中文关键词无效
有人尝试写 "onLanguage:中文" 或 "onCommand:打开设置"，结果插件从不激活——activationEvents 是硬编码匹配机制，只认英文标识符，不解析自然语言。
- 语言激活必须用标准语言 ID：
"onLanguage:javascript"、"onLanguage:python"，没有zh或chinese类型 - 命令激活必须与
commands.registerCommand()中注册的 ID 完全一致，例如"extension.toggleFeature"，不能写成中文字符串 - 想实现“用户打开 .vue 文件时激活”，正确写法是
"onLanguage:vue"，而非"onFileOpen:.vue"（后者不存在）
tsconfig.json 和 node_modules 中文路径导致构建失败
项目路径含中文（如 D:\我的项目\my-extension）时，执行 tsc 编译可能报错 error TS5055: Cannot write file ... because it would overwrite input file，这是 TypeScript 早期版本对非 ASCII 路径处理不稳定所致。
- VS Code 1.85+ 已修复大部分路径问题，但仍建议开发目录使用纯英文命名（
my-extension而非我的插件） -
node_modules下某些包（如esbuild）的二进制文件路径含空格或中文时，Webpack 构建会静默失败，错误日志里找不到线索 - 真正麻烦的是调试断点：Source Map 映射路径含中文时，Debugger 无法准确定位到
src/功能模块.ts，只能停在编译后的out/功能模块.js上
真正的中文辅助不在工具表面，而在你读文档时能否快速定位到 ExtensionContext.subscriptions 这类关键字段——它决定了资源是否泄漏，比任何翻译都重要。
