VSCode插件开发需区分三层中文支持：界面语言靠用户级locale.json设"zh-cn"，Node.js运行时需终端与env编码为UTF-8，插件元数据必须纯ASCII；三者混淆会导致调试乱码、vsce打包失败或publish报错。
VSCode插件开发环境本身不依赖中文语言包运行，但界面语言、调试控制台输出、错误提示和文档阅读体验直接受locale设置与系统区域影响——配置错位置或时机，会导致插件调试时console.log乱码、vsce package构建失败、甚至yo code模板生成异常。
configureDisplayLanguage 命令必须在用户级别执行
插件开发中频繁切换工作区（如同时维护多个 extension 项目），若在工作区级设置"locale": "zh-cn"，VSCode 会忽略该配置——它只读取用户级 locale.json。常见现象是：重启后仍显示英文菜单，或命令面板搜索“配置语言”无响应。
- 务必用快捷键
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入
Configure Display Language并回车，不要手动编辑settings.json - 选择
zh-cn后，VSCode 会自动在%USERPROFILE%\AppData\Roaming\Code\User\locale.json（Windows）或$HOME/Library/Application Support/Code/User/locale.json（macOS）写入配置 - 保存后必须完全退出 VSCode 进程（任务管理器中确认无
Code.exe或Electron剩余进程），再重新启动
插件调试时中文日志乱码的根因是 Node.js 编码环境
即使界面已汉化，你在 extension.ts 中写的 console.log("加载成功") 在调试控制台仍可能显示为 ??成功。这不是 VSCode 问题，而是 Node.js 子进程未继承系统 UTF-8 编码。
- Windows 用户需确保终端（PowerShell/CMD）默认代码页为 65001：
chcp 65001，并将其写入 PowerShell 配置文件（$PROFILE） - 在
launch.json的调试配置中显式指定编码："env": { "NODE_OPTIONS": "--inspect --no-warnings" }不够，应补充"env": { "PYTHONIOENCODING": "utf-8", "LANG": "zh_CN.UTF-8" }（Linux/macOS）或"env": { "CHCP": "65001" }（Windows） - 避免在
package.json的activationEvents或contributes中使用中文字符串——VSCode 插件市场校验会拒绝含非 ASCII 字符的字段值
vsce 打包失败常因 locale.json 被误提交进源码
执行 vsce package 时若报错 ENOENT: no such file or directory, open 'D:\xxx\locale.json'，大概率是你把用户级 locale.json 误加进了插件项目目录，且 .vscodeignore 未排除它。
-
vsce默认打包当前目录下所有非忽略文件，而locale.json是 VSCode 用户配置，绝不能出现在插件源码中 - 检查项目根目录是否意外存在
locale.json；如有，立即删除，并确认.gitignore和.vscodeignore均包含locale.json - 验证方式：运行
vsce ls，输出列表中不应出现任何locale.*或User/路径相关项 - 若使用
yo code生成模板，其自带的.vscodeignore已排除**/.vscode/**，但不会管你手动生成的locale.json
插件开发的中文支持不是“装个语言包就完事”，关键在区分三层：VSCode 界面语言（locale.json）、Node.js 运行时编码（终端 + env）、插件元数据规范（纯 ASCII）。三者混在一起配，十次有八次会卡在调试控制台黑方块或 vsce publish 报 400 错误。
