VS Code 设置中文必须通过 locale.json 文件配置,路径和内容须严格匹配:Windows 为 %APPDATA%\Code\User\locale.json,macOS 为 $HOME/Library/Application Support/Code/User/locale.json,Linux 为 $HOME/.config/Code/User/locale.json;文件内容仅允许单行标准 JSON {"locale":"zh-cn"}(UTF-8 无 BOM,小写、短横线、双引号),且需彻底终止所有 VS Code 后台进程后重启,右下角显示 zh-cn 即生效。

locale.json 文件路径和内容格式必须严格匹配
VS Code 只读取特定位置的 locale.json,且只识别标准 JSON 格式中 "locale": "zh-cn" 这一种写法。写成 "zh_CN"、"zh"、"Chinese" 或漏掉双引号,都会导致回退英文。
正确路径(按平台):
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json
文件内容只能是单行合法 JSON:{"locale":"zh-cn"}(UTF-8 无 BOM 编码)。别往里加注释、空格或多余字段——VS Code 解析失败就静默忽略。
为什么改了 locale.json 还是英文?进程没杀干净
VS Code 启动后会在后台驻留进程(Windows 是 Code.exe,macOS 是 Electron),即使关掉所有窗口,语言配置也不会重载。这是最常被跳过的一步。
必须执行:
- Windows:打开任务管理器 → 结束所有
Code.exe和Code Helper进程 - macOS:打开活动监视器 → 搜索并强制退出所有
Electron进程 - Linux:终端运行
pkill -f code或ps aux | grep code | grep -v grep | awk '{print $2}' | xargs kill
重启后右下角状态栏会显示 zh-cn,点它可快速验证是否生效。
别装 Chinese (Simplified) Language Pack 插件(新版不用)
VS Code 1.76+ 已将简体中文资源内置进核心二进制,安装 Chinese (Simplified) Language Pack for Visual Studio Code 插件反而可能引发冲突:
- 启动变慢(额外加载冗余翻译资源)
- 升级后
locale.json被重置为"en" - 与系统区域设置错位(比如 Windows 区域设为日本,插件却硬塞中文)
除非你用的是已停止维护的老版本(如 1.75 及更早),否则只需确保 locale.json 存在且值为 "zh-cn" 即可。命令面板里搜不到 Configure Display Language?说明插件根本不需要装。
企业版 / Snap 安装 / 多用户环境要加启动参数
某些定制分发版(如 Linux Snap 包、企业策略部署版)会绕过用户级 locale.json。此时直接修改文件无效,必须在启动时显式指定:
终端运行:code --locale=zh-cn
若需永久生效:
- Linux Snap:创建别名
alias code='code --locale=zh-cn'并写入~/.zshrc - Windows:修改快捷方式目标,在末尾加空格 +
--locale=zh-cn - macOS:用 Automator 封装带参数的 App,或改
~/Library/Application Support/Code/User/settings.json加"window.titleBarStyle": "native"配合环境变量(较复杂,不推荐)
真正卡住人的从来不是“找不到文件”,而是改了没杀进程、装了不该装的插件、或者在错误的发行版上套用了通用流程。


















