讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在VSCode中配置locale.json实现中文显示

风明酱_6218

风明酱_6218

发布时间:2026-09-27 07:24:21

|

553人浏览过

|

来源于php中文网

原创

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;内容仅允许 {"locale":"zh-cn"}(UTF-8 无 BOM,半角符号,无空格或注释);修改后须彻底重启 VS Code;settings.json 中的 locale 字段已失效。

如何在vscode中配置locale.json实现中文显示

locale.json 文件路径必须准确无误

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

如果路径中存在中文用户名、空格或符号(如 C:\Users\张三\AppData\...),建议先用命令面板打开设置:按 Ctrl+Shift+P → 输入 Open User Settings (JSON),再从那里跳转到对应目录,避免手动拼错。

locale.json 内容格式极其严格

这个文件不是配置集合,它只干一件事:声明界面语言。VS Code 对内容格式零容忍,哪怕多一个空格、用错引号、带 BOM 头,整个文件就被忽略。

正确内容只有一行,且必须完全匹配:

{"locale":"zh-cn"}

常见错误包括:

Aria2 Json Rpc
Aria2 Json Rpc

通过 JSON‑RPC 2.0 与 aria2 下载管理器交互,使用自然语言命令管理下载、查询状态并控制任务。适用于 aria2、下载管理或种子操作。

下载
  • 写成 zh_CN、zh-hans、Chinese 或 ZH-CN —— 全无效
  • 用了全角引号(“”)或中文冒号(:)
  • 保存为 UTF-8 with BOM(记事本默认选项)——必须选“UTF-8 无 BOM”
  • 加了注释、逗号、换行或任何额外字段,比如 {"locale":"zh-cn","version":1}

手动创建 locale.json 后必须彻底重启 VS Code

改完 locale.json 不等于立刻生效。VS Code 启动时才读一次该文件,运行中修改不会热加载。

关键动作是「彻底退出 + 全新启动」:

  • Windows:任务管理器里杀掉所有 Code.exe 进程(不止前台窗口)
  • macOS:活动监视器中结束 Code Helper 和 Electron 相关进程
  • Linux:执行 pkill -f "code.*--no-sandbox" 或手动检查 ps aux | grep code

验证是否成功:打开后看右下角状态栏是否显示 zh-cn;再打开命令面板(Ctrl+Shift+P),顶部提示是否变成「请输入命令或搜索设置」。

settings.json 里写 locale 已经完全失效

VS Code 1.70+ 版本起,settings.json 中的 "locale": "zh-cn" 字段被彻底移除支持。它不仅不生效,还可能干扰 locale.json 的读取逻辑。

如果你在 settings.json 里看到这行,直接删掉。两个文件职责分明:

  • locale.json:专管界面语言(唯一有效位置)
  • settings.json:管编辑器行为(缩进、字体、自动保存等)

混用或试图覆盖,只会让问题更难排查。

真正容易被忽略的是:终端、调试控制台、Git 日志、部分插件弹窗天生不走 locale.json 配置。它们显示英文不是汉化失败,而是各自依赖系统 locale 或运行时环境。盯住顶部菜单栏、命令面板提示、设置左侧导航这三处,对了就是真生效。

热门AI工具

更多
二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

3856

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1215

2023.07.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1578

2023.08.03

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

9323

2023.08.17

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

860

2023.09.01

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2284

2023.09.04

Js中concat和push的区别
Js中concat和push的区别

Js中concat和push的区别:1、concat用于将两个或多个数组合并成一个新数组,并返回这个新数组,而push用于向数组的末尾添加一个或多个元素,并返回修改后的数组的新长度;2、concat不会修改原始数组,是创建新的数组,而push会修改原数组,将新元素添加到原数组的末尾等等。本专题为大家提供concat和push相关的文章、下载、课程内容,供大家免费下载体验。

1449

2023.09.14

js截取字符串的方法介绍
js截取字符串的方法介绍

JavaScript字符串截取方法,包括substring、slice、substr、charAt和split方法。这些方法可以根据具体需求,灵活地截取字符串的不同部分。在实际开发中,根据具体情况选择合适的方法进行字符串截取,能够提高代码的效率和可读性 。

3849

2023.09.21

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

160

2026.09.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn