Windows 上 locale.json 路径为 %APPDATA%\Code\User\locale.json,macOS 为 ~/Library/Application Support/Code/User/locale.json,Linux 为 ~/.config/Code/User/locale.json;Remote-SSH 和 WSL 需配置远程端对应路径;文件需手动创建,内容为 {"locale":"zh-cn"},UTF-8 无 BOM 编码。

Windows 上 locale.json 的确切路径
文件位于 %APPDATA%\Code\User\locale.json,也就是 C:\Users\用户名\AppData\Roaming\Code\User\locale.json。注意:AppData 是隐藏文件夹,需在文件资源管理器地址栏直接粘贴路径才能进入;用记事本或 VS Code 打开时,务必确认保存为 UTF-8 无 BOM 编码。
macOS 和 Linux 路径差异与常见误写
macOS 实际路径是 ~/Library/Application Support/Code/User/locale.json,不是 ~/Library/Preferences/Code/ 或 ~/Library/Caches/ —— 后两者完全无效。Linux 对应路径为 ~/.config/Code/User/locale.json,注意 .config 是隐藏目录,且 ~ 必须指向真实用户主目录(比如 WSL 中若 ~ 指向 /mnt/d/home,该文件会被静默忽略)。
Remote-SSH 和 WSL 中 locale.json 不在本地
远程连接后界面仍是英文,不是配置错了,而是你改了本地的 locale.json,但 Remote-SSH 和 WSL 启动的是独立的 VS Code Server 进程,只读取远程端的对应文件:
使用约定式提交(Conventional Commits)生成标准化的 Git 提交信息。适用于以下场景: (1) 暂存更改时需要提交信息; (2) 审查 diff 时希望获得结构化摘要; (3) 编写 PR 描述或变更日志(changelog)条目; (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff,并生成按类型(type)划分范围的提交信息。
- Remote-SSH:登录目标机器后,检查
~/.vscode-server/data/Machine/locale.json(1.85+ 默认)或旧版~/.vscode-remote/data/Machine/locale.json - WSL:在 WSL 终端中执行
ls -la ~/.vscode-server/data/Machine/,确认locale.json存在于该目录下,内容为{"locale":"zh-cn"}
locale.json 文件不存在?别猜,直接创建
VS Code 不会自动生成 locale.json,哪怕你装了中文语言包、点了 Configure Display Language 命令——如果命令面板卡死、没反应或提示“not found”,它就根本没写入。此时最可靠的做法是手动创建:
- 彻底退出 VS Code(Windows 查任务管理器,macOS 用 Activity Monitor,Linux 用
pkill code) - 用任意文本编辑器新建文件,路径严格按系统要求,文件名必须是
locale.json(不是locale.txt、settings.json或大小写混用) - 内容只写一行:
{"locale":"zh-cn"}(双引号、小写、连字符、无空格、无注释、无逗号结尾) - 保存为 UTF-8 无 BOM 编码(VS Code 自带保存选项,Notepad++ 需手动选)
真正容易被忽略的点是:locale.json 必须存在且格式合法,VS Code 才会读取它;任何其他位置、任何其他命名、任何编码或语法偏差,都会导致它被完全跳过,界面无声无息退回英文。










