vs code 中文友好需界面汉化+工具链配置+插件协同:装中文语言包并设zh-cn后,还需配置typescript.locale和eslint.options使报错中文;error lens显式展示中文错误;codegeex适配中文注释与业务术语;auto rename tag和path intellisense支持中文路径,但需统一英文物理目录名。

VS Code 默认英文界面,对中文使用者存在天然门槛——菜单看不懂、报错提示要翻译、快捷键描述像天书。真正“中文友好”不是简单汉化,而是从界面、提示、补全、调试到协作全程不卡壳。
中文语言包必须装,但光装它不够
只装 Chinese (Simplified) Language Pack 会让菜单和设置变中文,但代码里的错误信息(比如 Cannot find name 'React')、ESLint 报错、TypeScript 类型提示、Git 提交日志依然全是英文。这些才是日常高频接触的内容。
- 安装后务必按
Ctrl+Shift+P→ 输入Configure Display Language→ 选zh-cn→ 重启,否则部分界面仍为英文 - 插件本身不改第三方工具链输出,想让 ESLint 或 TypeScript 错误也中文,得额外配
typescript.locale和eslint.options(需项目级配置) - 某些插件(如
GitLens)的弹窗文案可能残留英文,这是插件自身未适配导致,非语言包问题
Error Lens 让错误信息直接“说中文”
原生 VS Code 的红色波浪线要 hover 才能看到错误详情,且内容是英文。装了 Error Lens 后,错误/警告会直接显示在行尾,配合中文语言包 + 项目级 TypeScript 配置,能自然呈现中文提示(如“类型 ‘string’ 的参数不能赋给类型 ‘number’ 的参数”)。
- 它不翻译,但把原本藏在 tooltip 里的信息“拉出来”,让中文环境下的阅读路径变短
- 和
ESLint插件共存时,两者提示会并列显示,注意区分来源:ESLint 提示带[eslint]前缀,TS 错误则来自语言服务 - 若发现行尾没显示中文错误,先确认 TypeScript 服务是否启用:
Ctrl+Shift+P→Restart TS Server
CodeGeeX 是目前最贴近中文语境的 AI 补全插件
GitHub Copilot 对中文注释理解偏弱,常把“// 处理用户登录状态”当成无意义注释跳过。而 CodeGeeX 专为中文优化,能准确识别中文函数名、变量名、业务术语(如“订单履约”“风控拦截”),生成代码更贴合国内项目习惯。
- 支持本地模型(Ollama +
zhipu/glm4),代码不上传,适合处理含敏感字段的内部系统 - 右键菜单里有
CodeGeeX: Comment to Code,选中中文注释即可生成对应逻辑,比敲英文 prompt 更快 - 它不替换 Copilot,而是互补:Copilot 适合通用模板,CodeGeeX 适合中文上下文强依赖的业务代码
Auto Rename Tag 和 Path Intellisense 解决“写一半卡住”的中文路径痛点
Vue/React 项目里写 <usercard></usercard>,改名时手动同步闭标签容易漏;import 路径写到 src/views/ 就卡住,因为文件夹名是中文(如 用户管理)或拼音(user-manage),原生 IntelliSense 不识别。
-
Auto Rename Tag对中文组件名(如)同样生效,无需额外配置 -
Path Intellisense默认支持中文路径,但若项目用了 Webpack 别名(如@/pages/用户管理),需在jsconfig.json中显式声明"baseUrl": "src"和"paths映射 - 这两者都依赖文件系统真实路径,如果资源管理器里显示的是英文名(如
user-management),但实际文件夹是中文名,VS Code 可能无法索引——此时应统一用英文命名物理目录
中文友好不是“翻译完就结束”,而是让整个开发流在中文语境下不掉速。很多坑不在插件本身,而在插件与项目配置、文件命名、团队约定之间的缝隙里——比如一个中文文件夹名,既影响 Path Intellisense,也可能让 CI 构建失败。











