VS Code 中文化与常用扩展:一次配好中文界面、格式化、代码规范
VS Code 装好后一打开是全英文界面,很多人第一反应是「看不太懂」。其实切中文只需装一个官方语言包、改一处设置,几分钟搞定;之后再按需装格式化、Git 相关的常用扩展,开发体验立刻上一个台阶。本文按「中文化 → 基础扩展 → 分层配置」的顺序整理,全部基于官方扩展市场与官方配置项。
第一步:安装中文语言包并切换界面
中文语言包在 VS Code 官方扩展市场可以直接搜到,扩展名为 Chinese (Simplified) Language Pack,发布者是 Microsoft。安装路径:左侧活动栏点「扩展」图标(或 Ctrl+Shift+X),搜索 Chinese,找到 Microsoft 发布的中文语言包点击安装。
装完后界面不一定立刻变中文,因为需要显式切换语言:按 Ctrl+Shift+P 打开命令面板,输入 Configure Display Language,选择 zh-cn(简体中文),然后重启 VS Code(完全退出进程再启动)才会生效。如果重启后仍是英文,可在 settings.json 中手动加入 "locale": "zh-cn" 保存后重启。注意官方语言包只提供界面翻译资源,不会自动启用,这一步不能省。
第二步:必装的基础扩展
中文化之后,按需选择以下扩展,它们都在官方扩展市场可搜、由知名组织维护:
- vscode-icons:给不同文件类型显示图标,目录结构一眼扫清。
- Path Intellisense:输入路径时自动补全文件与文件夹名。
- ESLint:JavaScript/TypeScript 代码规范检查,红波浪线直接标出问题。
- Prettier - Code formatter:统一代码格式,保存时自动整理。
- GitLens:在代码行内显示提交记录、作者与改动时间,Git 操作更直观。
- Python:微软官方 Python 扩展,提供补全、调试与运行支持。
- Chinese 布局补充:如需要右键菜单更深层汉化,可再找社区版中文菜单类扩展。
不要一次装几十个扩展,推荐「先装核心、用到再加」:格式化用 Prettier、规范检查用 ESLint、Git 增强用 GitLens,这三件套覆盖了绝大多数开发场景。
第三步:扩展分层与冲突预防
扩展装多了也会互相打架,典型的是 Prettier 与 ESLint 的格式化规则冲突。建议分层启用:基础层(中文语言包、vscode-icons、Path Intellisense)必开;开发层(ESLint、Prettier、Python 等)按语言栈启用,并在项目 settings.json 中为 Prettier 单独配置格式化规则;观察层(GitLens 等较重扩展)谨慎开启,工作区很大时可关闭其中高开销的视图功能,避免拖慢启动。
验证方法:把所有扩展禁用,单独启用中文语言包确认汉化稳定,再逐个启用其他扩展,若启动明显卡顿就回退排查。这一过程在官方文档中也有对应建议,可对照执行。
第四步:保存格式化与常用设置
在「设置」搜索以下两项开启后体验最好:搜索 format on save,勾选 Editor: Format On Save(保存时自动格式化);搜索 format on paste,勾选 Editor: Format On Paste(粘贴后格式化)。配合 Prettier,写代码时不用手动整理缩进和引号。另外建议在「设置 → 用户」里查看 Git 相关配置,把默认 Git 路径指向正确的 git.exe(可在「设置」搜索 git.path,一般留空即自动识别)。
常见问题速查
| 问题 | 处理方式 | |------|---------| | 装了语言包界面还是英文 | 执行 Configure Display Language 选 zh-cn 并彻底重启进程 | | 终端/调试输出仍是英文 | 属正常现象,这些模块走独立本地化逻辑 | | 保存不自动格式化 | 确认已装 Prettier 且勾选 Format On Save,检查是否被其他扩展覆盖 | | 扩展市场打不开 | 检查网络;企业环境可能需要配置代理,以官方文档说明为准 | | code 命令提示找不到 | 安装时未添加 PATH,可在命令面板运行 Shell Command: Install 'code' command |
VsCode 的扩展可以按「用户级」与「工作区级」分别生效:用户级扩展对所有项目生效,适合语言包、图标这类通用能力;工作区级扩展(通过工作区的 .vscode 配置推荐)随项目共享,团队协作时新人打开项目即可按提示安装,格式与规范检查类扩展建议放在这一层。远程开发场景还可以安装微软官方的 Remote-SSH 与 Dev Containers 扩展,本地编辑代码、实际在远程服务器或容器里运行,日常开发常用。这些扩展同样在官方市场内搜索安装即可。Windows 上安装用户级还是系统级版本的选择,可参考站内的 VS Code 安装器对比文章。
装完做这几件确认
- [ ] 中文语言包已安装,Configure Display Language 已选 zh-cn 并重启生效
- [ ] 已安装 vscode-icons 与 Path Intellisense,目录与路径提示正常
- [ ] ESLint 与 Prettier 已装且配置了格式化规则,无冲突报错
- [ ] 已开启 Format On Save,实测保存文件自动整理格式
- [ ] GitLens 等观察层扩展按需启用,VS Code 启动流畅