vs code界面汉化必须手动创建locale.json文件并严格按系统路径存放,内容仅限{"locale":"zh-cn"},改完需彻底退出进程后重启才生效。

locale.json 文件必须手动创建并写对路径
VS Code 默认不生成 locale.json,哪怕装了中文语言包,只要这个文件不存在或路径错,界面就永远是英文。它只读用户级配置,不认工作区或系统级位置。
正确路径(三选一,严格对应系统):
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
如果路径中含中文、空格、符号(如括号),VS Code 会静默忽略该文件;建议用资源管理器/访达直接粘贴路径打开文件夹,再新建文本文件。
内容只能是严格 JSON 单行 {"locale":"zh-cn"}
locale.json 不是配置模板,不是注释文件,不是 settings.json 的子集——它只接受且仅接受这一行内容:
{"locale":"zh-cn"}
常见错误包括:
- 写成
{"locale": "zh_CN"}(下划线无效)、{"locale": "zh-hans"}(旧版兼容已废止) - 加了多余空格:
{ "locale" : "zh-cn" }或末尾多逗号 - 用了全角引号、中文冒号、BOM 头(务必用“UTF-8 无 BOM”编码保存)
- 文件里混入注释、其他字段、换行符
一旦格式出错,VS Code 不报错,也不提示,直接回退到英文界面。
使用固定的 Next.js/Tailwind/Prisma 技术栈构建并记录独立 SaaS 项目,仅将 FastAPI 用于 Python 工作负载,并遵循严格的架构规范。
改完必须彻底退出 VS Code 进程再重启
VS Code 只在启动时读一次 locale.json。修改后点「重新加载窗口」完全无效,因为进程没重启,语言上下文未重建。
操作要点:
- 关闭所有 VS Code 窗口(包括隐藏的托盘图标)
- Windows:打开任务管理器,结束所有
Code.exe进程 - macOS:活动监视器中搜索
Electron或Code,强制退出全部相关进程 - Linux:终端执行
pkill -f "code"或查ps aux | grep code后 kill
再双击图标或命令行输入 code 启动,右下角状态栏会立即显示 zh-cn,菜单栏变为「文件」「编辑」「视图」即生效。
别碰 settings.json 里的 "locale" 字段
settings.json 中写 "locale": "zh-cn" 完全无效。VS Code 从不读这个字段,它既不触发界面切换,也不影响任何行为,纯属浪费时间。
如果你看到网上教程这么写,说明作者没验证过 1.80+ 版本(2026 年主流版本),或者混淆了旧版行为。当前唯一有效入口就是 locale.json —— 它绕过 UI 层、不依赖插件状态、不走命令面板逻辑,是最底层、最可靠的控制点。
真正容易被忽略的是:终端、调试控制台、Git 提示、部分插件弹窗始终显示英文,这不是配置失败,而是它们根本不读 locale.json。盯住顶部菜单栏、命令面板(Ctrl+Shift+P)、设置界面(Ctrl+,)这三处,对了就是真成功。










