locale.json写入失败主因是系统权限、文件格式或进程占用。需检查路径可写性、确保utf-8无bom编码及{"locale":"zh-cn"}严格格式，并关闭onedrive/杀软/残留进程等干扰项。
locale.json 写不进去，基本不是 VSCode 问题，而是系统拒绝写入或文件本身不合规。 它不会报错，只会静默失败——你点 Configure Display Language、选 zh-cn、点 Restart，结果 locale.json 还是空的、没变、或者内容乱码，说明写入被拦截了。
locale.json 路径和权限是否可写
VSCode 启动时会尝试往用户数据目录写 locale.json，但路径不可写就直接放弃。常见位置：
- Windows：
%APPDATA%\Code\User\locale.json - macOS：
~/Library/Application Support/Code/User/locale.json - Linux：
~/.config/Code/User/locale.json
检查方式：
- Windows：在资源管理器地址栏粘贴
%APPDATA%\Code\User，右键该文件夹 → 属性 → 安全 → 确认当前用户有“写入”权限 - macOS/Linux：终端执行
ls -ld ~/.config/Code/User，若属主不是你（比如是root），运行sudo chown -R $USER:$GROUPS ~/.config/Code/User - 别用管理员/Root 启动 VSCode——这会让它以高完整性级别运行，反而无法向普通用户目录写入
locale.json 内容是否严格合规
VSCode 对这个文件格式极其敏感，错一个字符就忽略整份配置，退回英文。必须满足：
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
- 文件只含一行纯文本：
{"locale":"zh-cn"}（注意双引号、小写、连字符、无空格） - 编码必须是 UTF-8 无 BOM；用记事本保存会加 BOM，建议用 VSCode 自身新建文件并选「UTF-8」编码保存
- 不能有注释（
//或/* */）、不能有多余逗号、不能用中文引号、不能写成zh_CN或zh-hans - 不要把它和
settings.json合并——locale.json 是独立文件，不是 settings 的一部分
其他进程是否锁住了 locale.json
文件被占用时，VSCode 写入会失败且不提示。典型元凶：
- OneDrive / iCloud / Dropbox 正在同步该目录（尤其是 Windows 下
%APPDATA%常被 OneDrive 监控） - 另一个 VSCode 实例仍在后台运行（任务栏托盘图标未退出，或 Remote-SSH 连接未断）
- 杀毒软件实时扫描（如 Windows Defender 的
AntimalwareServiceExecutable.exe） - 终端里有
tail -f或watch正在监听该路径
操作前务必：
- 右键任务栏 VSCode 图标 → “退出”（不是关窗口）
- Windows 查任务管理器，结束所有
Code.exe和Code Helper进程 - macOS/Linux 运行
lsof ~/.config/Code/User/locale.json看谁在占着
Remote-SSH / WSL 场景下 locale.json 生效位置不对
你在本地配好了，连上 Remote-SSH 或 WSL 后还是英文？因为远程 VS Code Server 不读你本地的 locale.json，它只读远程机器上的对应路径：
- Remote-SSH：登录远程服务器，打开
~/.vscode-server/data/Machine/下最新哈希子目录，再进User/，放locale.json - WSL：在 WSL 终端里执行
code .启动，确保 locale.json 在 WSL 的~/.config/Code/User/下，而不是 Windows 的%APPDATA% - 别指望本地设置自动同步过去——这是两个独立运行环境
真正卡住的从来不是“怎么写”，而是“写到哪”“谁让写”“写得对不对”。手动创建 locale.json 前，先确认路径可写、没被锁、没开管理员模式——这三个条件漏掉任何一个，后面所有操作都是白忙。
