vscode终端中文显示异常是因字体未显式配置中文字体，需在settings.json中用单引号包裹中文字体名并逗号分隔，如"'microsoft yahei', 'simsun'"，且必须重启终端窗口生效。
terminal.integrated.fontFamily 没配对中文字体
终端显示方块、问号或空白，不是编码错，是字体压根不支持中文渲染。VSCode 不会自动 fallback 到系统中文字体，必须显式声明。
实操建议：
- 打开
settings.json，添加或修改"terminal.integrated.fontFamily" - 值必须用单引号包裹中文字体名，多个字体用英文逗号分隔，例如：
"'Cascadia Code', 'Microsoft YaHei', 'SimSun', monospace" - Windows 用户避免只写
"SimSun"：它缺少等宽变体，侧边栏/状态栏文字易错位；Microsoft YaHei更稳 - macOS 用户应优先用
"PingFang SC"或"Heiti SC"；写"Helvetica Neue"会跳过中文渲染 - Linux 用户需确认已安装
fonts-wqy-zenhei或noto-fonts-cjk；仅靠DejaVu Sans无法覆盖全部汉字
字体名大小写或引号格式错误
VSCode 对 terminal.integrated.fontFamily 的语法极其敏感：引号缺失、中英文标点混用、大小写不一致都会导致整个字段失效，回退到默认无中文支持字体。
常见错误现象：
- 配置后重启终端，中文仍显示为方块，但英文正常
- 右下角字体名称显示为“monospace”或空
- 在设置 UI 中看到该字段被标红或提示 “Invalid value”
实操建议：
- 确保所有字体名外层用双引号包裹整个字符串，内部中文字体名用单引号，如：
"'Microsoft YaHei', 'Courier New'" - 不要用中文逗号、全角引号、反引号或省略引号
- 避免大小写拼错：Windows 下是
Microsoft YaHei，不是microsoft yahei或Microsoft yahei - 可临时简化成单字体测试，例如：
"'Microsoft YaHei'"，确认生效后再加备选
终端字体与编码设置混淆
很多人误以为改了 terminal.integrated.encoding 就能解决方块问题——这个字段早在 VSCode 1.80+ 已被弃用，设了也无效。它和字体无关，只影响旧版解码逻辑（现已由 chcp 和环境变量接管）。
实操建议：
- 彻底删除
terminal.integrated.encoding相关配置，避免干扰判断 - 确认乱码是否真属字体问题：复制中文到终端里粘贴，如果显示为方块，且
chcp返回65001、PYTHONIOENCODING=utf8已生效，则 99% 是字体未命中 - 在外部 PowerShell 或 CMD 中运行
chcp 65001 && echo 你好正常，但在 VSCode 终端里仍为方块 → 基本锁定为字体配置问题
字体文件实际未安装或路径不可达
VSCode 只认系统级注册的字体，不读取用户下载后未安装的 .ttf 文件。尤其在 macOS 和 Linux 上，“已下载字体” ≠ “已启用字体”。
实操建议：
- macOS：用“字体册”App 安装字体，并勾选“安装到用户”或“安装到电脑”，不能只双击预览
- Linux：Ubuntu/Debian 运行
sudo apt install fonts-wqy-zenhei；Arch 系用sudo pacman -S noto-fonts-cjk - Windows：检查 C:\Windows\Fonts 目录下是否存在对应字体文件（如
msyh.ttc对应 Microsoft YaHei） - Cascadia Code 需手动安装：从 GitHub release 下载并安装，否则配置中的
'Cascadia Code'会被直接跳过
