vs code 中文界面生效需严格满足三要素:locale.json 必须置于用户级指定路径(windows:%appdata%\code\user\locale.json;macos:~/library/application support/code/user/locale.json;linux:~/.config/code/user/locale.json),内容仅允许一行合法 utf-8 无 bom json {"locale":"zh-cn"},且修改后须彻底退出所有进程并重启,否则不重载。

locale.json 文件路径必须精准匹配用户数据目录
VS Code 只读取特定路径下的 locale.json,写错位置等于没配。它不认工作区里的 .vscode/locale.json,也不读系统级或远程配置目录。
- Windows:
%APPDATA%\Code\User\locale.json(不是%USERPROFILE%\AppData\Roaming\Code\User的别名路径,二者等价但推荐用%APPDATA%) - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
路径中 User 这一级不能漏,locale.json 必须小写、无扩展名变体(如 locale.json.bak 或 Locale.json 都无效)。
文件内容只允许一行合法 JSON,且编码必须为 UTF-8 无 BOM
任何多余字符都会导致 VS Code 静默忽略该文件,界面维持英文。这不是报错,而是直接 fallback。
- 正确内容(严格复制):
{"locale":"zh-cn"} - 常见错误:
{"locale": "zh-cn"}(多空格)、{"locale":"zh_CN"}(下划线非法)、{"locale":"Chinese"}(非标准值)、{"locale":"zh-cn",}(末尾逗号) - 用记事本保存极易带 BOM;建议用 VS Code 自己新建文件并保存,它默认就是 UTF-8 无 BOM
修改后必须彻底退出再启动,否则 locale 不重载
VS Code 的语言配置在进程启动时一次性读取,运行中改 locale.json 不生效。所谓“重载窗口”(Developer: Reload Window)不会重新解析该文件。
详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
- Windows:任务管理器中确认所有
Code.exe进程已结束(包括后台服务进程) - macOS:活动监视器里杀掉所有
Electron和Code Helper相关进程 - Linux:执行
pkill -f "code.*--user-data-dir"或手动检查ps aux | grep code
右下角状态栏显示当前语言代码(如 zh-cn),点击它可快速验证是否已加载成功。
Remote-SSH / WSL 环境需单独配远程端的 locale.json
本地设好了,连上远程还是英文?不是配置失效,是 VS Code Server 在远程机器上跑的是另一个实例,它读的是远程路径下的 locale.json。
- Remote-SSH:连接后按
Ctrl+Shift+P运行Developer: Open User Data Folder,进User/目录操作 - WSL:终端中先运行
code --list-extensions确保 Server 已启,再进~/.vscode-server/data/Machine/xxx/User/locale.json(xxx 是哈希目录名) - 远程端的语言包也得单独安装,本地插件不会同步过去
最容易被忽略的是:你改了文件、也重启了,但没意识到自己正处在 Remote-SSH 会话里——此时一切操作都得在远程上下文中完成。










