vscode终端中文显示问号的根本原因是windows终端默认gbk编码与工具链utf-8输出不匹配;需在settings.json中配置terminal.integrated.profiles.windows(含chcp 65001启动参数)和terminal.integrated.env.windows(设pythonioencoding=utf-8及lang/lc_all),并重启vscode生效。

VSCode运行代码时中文显示问号,不是文件编码错了,而是终端进程没走 UTF-8 编码路径——Windows 下 PowerShell/CMD 默认用 GBK(代码页 936),但 Python、C、Java 等工具链默认按 UTF-8 输出,解码错位就必然出现问号或方块。
PowerShell 终端启动就乱码:chcp 65001 必须在进程初始化时生效
手动输 chcp 65001 能临时修复,但每次新开终端都要重输,说明没嵌入启动流程。VSCode 的 terminal.integrated.profiles.windows 配置必须带 -NoExit 和 -Command,否则命令执行完终端就退出。
- 在
settings.json中添加:
"terminal.integrated.profiles.windows": {
"PowerShell": {
"source": "PowerShell",
"args": ["-NoExit", "-Command", "chcp 65001 > $null"]
}
}
$null 是为了隐藏 Active code page: 65001 提示,不加也不影响功能
- 改完后必须重启 VSCode,仅重启终端不够——旧 shell 进程的环境已固化
- 验证是否生效:新开终端后运行
[Console]::OutputEncoding,应返回System.Text.UTF8Encoding
Git Bash 中文路径报错或显示为问号:LANG 环境变量为空或设成 C
Git Bash 本身支持 UTF-8,但它依赖 LANG 和 LC_ALL 判断是否启用宽字符支持。一旦这两个变量是空值或 C,它就退回到 ASCII 模式,拒绝处理中文路径和输出。
- 在
settings.json中添加:
"terminal.integrated.env.windows": {
"LANG": "zh_CN.UTF-8",
"LC_ALL": "zh_CN.UTF-8"
}
- 确保 Git 安装时勾选了 “Use Windows' default console window” —— 没勾选会导致底层 msys2 运行时 fallback 到旧模式
- 绝对不要在
.bashrc里写export LANG=C,这是高频踩坑点,会覆盖 VSCode 注入的环境变量 - 验证方式:新开 Git Bash 终端后运行
locale,输出中LANG应为zh_CN.UTF-8,且无警告
C语言 printf 中文变问号:setlocale(LC_ALL, "") 必须放在第一行且参数为空字符串
只加 #include <locale.h></locale.h> 不够,不调用 setlocale 或参数写成 "Chinese"、"chs" 之类,完全无效。Windows 下唯一可靠写法是空字符串,让 C 运行时自动读取系统区域设置。
- 正确写法(必须放在所有
printf之前):
#include <stdio.h>
#include <locale.h>
int main() {
setlocale(LC_ALL, ""); // 关键:空字符串
printf("你好,世界!\n");
return 0;
}</locale.h></stdio.h>
- 不要用
setlocale(LC_CTYPE, "Chinese_China.936")这类硬编码——不同 Windows 版本代码页可能有差异,空字符串最稳 - 源文件保存编码必须与
setlocale匹配:若设的是""(继承 GBK),文件就得用 GBK 保存;若想统一用 UTF-8,得配合setlocale(LC_ALL, ".65001"),但旧版 Windows 控制台不支持 - VSCode 右下角状态栏点击编码 → 选
Reopen with Encoding→GBK,再Save with Encoding→GBK,避免源码和运行时编码错位
Python print("中文") 仍乱码:sys.stdout.encoding 被骗成 cp936
即使终端已切到 UTF-8,Python 启动时仍可能读取 Windows API 返回的 GetConsoleCP()(通常是 936),于是把 sys.stdout.encoding 设为 gbk,导致 write() 写入失败或被替换为问号。
- 最稳妥的一劳永逸方案:在
settings.json中加环境变量,让 Python 进程启动前就“知道”该用什么编码:
"terminal.integrated.env.windows": {
"PYTHONIOENCODING": "utf-8"
}
- 注意:这个变量名必须全小写
PYTHONIOENCODING,大小写错误不生效 - 验证方式:新开终端后运行
python -c "import sys; print(sys.stdout.encoding)",输出必须是utf-8 - 如果用
launch.json调试,也要在env字段里加上同名变量,否则调试器启动的 Python 进程不受影响
真正容易被忽略的点是:所有配置改完后必须重启 VSCode,而不是只关终端再开——旧 shell 进程的编码状态已经固化,新配置只对全新进程生效。另外,terminal.integrated.env.windows 和 terminal.integrated.profiles.windows 是两个独立配置项,漏掉任何一个都可能导致部分场景失效。











