VSCode错误提示显示中文需配置底层工具而非VSCode本身:tsc需tsconfig.json设"locale":"zh-CN",gcc需MinGW-w64版加LC_ALL环境变量,其他工具基本无官方中文支持。

VSCode 本身不翻译编译器或语言服务器的错误信息,所谓“错误提示显示中文”,本质是让底层工具(如 gcc、clang、tsc、pyright)输出中文报错,VSCode 只负责原样展示。直接改 VSCode 设置无法实现这点。
为什么改 locale 对错误信息没用
设置 Preferences: Locale 为 zh-cn 只影响 VSCode 界面(菜单、设置项、弹窗等),不影响终端里运行的编译器、TypeScript 语言服务、Python 类型检查器这些外部进程的输出语言。它们是否输出中文,取决于自身是否支持、是否启用、以及系统环境变量是否匹配。
-
gcc在 Windows 上默认输出英文,即使系统区域设为中文,也不自动切语言 -
tsc(TypeScript 编译器)需显式传参--locale zh-CN才会输出中文错误 -
pyright/mypy默认无中文支持,依赖语言包或社区补丁,官方未内置
让 tsc 错误变中文:加 --locale 参数
TypeScript 用户最可能见效。VSCode 的 TS 语言服务默认调用 tsc,但不带 --locale。你需要在项目级配置中强制启用:
- 打开项目根目录的
tsconfig.json - 添加
"locale": "zh-CN"到compilerOptions中 - 重启 TS 服务:按
Ctrl+Shift+P→ 输入Typescript: Restart TS server
示例 tsconfig.json 片段:
{
"compilerOptions": {
"target": "ES2020",
"module": "commonjs",
"locale": "zh-CN"
}
}
让 gcc / g++ 错误变中文:靠环境变量 + MinGW-w64 版本
Windows 下 MinGW-w64 的 gcc 支持中文错误,但有硬性前提:
- 必须使用带
gettext国际化支持的 MinGW-w64 构建版本(WinLibs 默认包含) - 启动 VSCode 前,需设置系统环境变量
LC_ALL=zh_CN.UTF-8或LANG=zh_CN.UTF-8 - 推荐在 VSCode 终端启动前注入:编辑
settings.json,加这段
"terminal.integrated.env.windows": {
"LC_ALL": "zh_CN.UTF-8"
}
注意:gcc 的中文错误仅出现在集成终端(Ctrl+`)中执行 gcc main.c 时;C/C++ 扩展的 IntelliSense 报错仍为英文(因其走的是 Microsoft C++ IntelliSense 引擎,非 gcc)。
其他语言:基本无官方中文错误支持
目前主流语言工具链中,只有 tsc 和部分 MinGW-w64 构建版 gcc 提供稳定可用的中文错误输出。Python 的 pylint、flake8、pyright,Rust 的 cargo,Go 的 go build 等,均无内置中文错误能力。强行本地化需依赖第三方 patch 或自定义 wrapper 脚本,稳定性差、更新易断裂。
真正容易被忽略的是:你看到的“错误提示”可能来自多个源头——终端里手动运行命令的输出、C/C++ 扩展的语义分析、TS/JS 的语言服务、ESLint 插件……它们彼此独立,没有统一语言开关。想全中文?得一个一个查文档、配参数、验效果,不存在一劳永逸的设置。











