VSCode插件市场中文乱码是Webview字体fallback失败所致，需在settings.json中配置"editor.fontFamily": "'Microsoft YaHei','SimSun','PingFang SC','Noto Sans CJK SC','monospace'"并重启；插件安装日志中文路径乱码则因Node.js子进程编码解析缺陷，必须将工作区移至纯英文路径。
VSCode 插件安装界面、插件描述页、扩展名或作者名里出现中文乱码（如“”“□”或空白方块），基本可以确定是 VSCode 自身 UI 渲染层的字体 fallback 失败，和文件编码、终端设置完全无关——改 files.encoding 或加 chcp 65001 都无效。
为什么插件市场页面中文显示为方块？
VSCode 的扩展 Marketplace 页面由 Webview 渲染，其字体链不读取系统默认中文字体，而是依赖编辑器配置的 editor.fontFamily 和底层 Chromium 的字体映射规则。Windows 上若未显式指定支持中文的英文字体名（如 "Microsoft YaHei"），Chromium 会尝试用等宽字体（如 Consolas）强行渲染汉字，结果就是方块。
- 常见现象：插件标题“Chinese (Simplified) Language Pack”正常，但作者名“张三”或描述里的“支持中文语法高亮”变成“□□□”
- 不是网络问题：右键“检查”能看到 DOM 中文本内容是正常的 UTF-8 字符，只是渲染失败
- 不影响功能：插件仍可正常安装、启用，只是 UI 层不可读
强制指定中文字体（Windows/macOS/Linux 通用）
必须用英文名写死字体，且按优先级顺序排列，确保 fallback 到真实可用的中文字体。不要写“微软雅黑”或“宋体”，要写 "Microsoft YaHei"、"SimSun"、"PingFang SC" 等标准英文名。
- 打开命令面板
Ctrl+Shift+P，输入Preferences: Open Settings (JSON) - 在
settings.json中添加或修改这一行：
"editor.fontFamily": "'Microsoft YaHei', 'SimSun', 'PingFang SC', 'Noto Sans CJK SC', 'monospace"
- 保存后重启 VSCode（仅重载窗口不够，必须彻底重启）
- 如果系统没装
Microsoft YaHei（如某些精简版 Windows 或 Linux），请先安装字体，再改配置
插件安装日志里出现中文路径乱码（如 “D:\开发\ext” 报错）
这不是 UI 渲染问题，而是插件安装器调用 npm 或 vsix 解压时，路径含中文触发了 Node.js 子进程的编码解析错误——和 VSCode 安装路径含中文是同一类底层缺陷。
- 典型报错：
Error: ENOENT: no such file or directory, mkdir 'D:\extensionsms-python.python' - 根本原因：VSCode 扩展安装流程调用
child_process.spawn，而 Windows 下该 API 默认用系统代码页（GBK）解析路径参数，但路径字符串本身是 UTF-8 编码 - 无配置可绕过：不能靠改
settings.json或环境变量修复 - 唯一解法：把 VSCode 工作区（即你打开的文件夹）移到纯英文路径下，例如
D:projectsmyapp - 注意：不是 VSCode 安装目录，而是你当前打开的文件夹路径 —— 即使 VSCode 装在
C: scode，只要工作区是D:开发demo，插件安装就可能崩
插件自身输出中文乱码（比如 Python 插件的 LSP 日志里中文变问号）
这类乱码发生在插件后台进程（如 pylsp、rust-analyzer）的标准输出里，属于子进程环境编码继承失败，和编辑器 UI 无关。
- 表现：打开
Output面板 → 切到Python或Language Server标签 → 看到[Error]这类日志 - 关键点：VSCode 的
Output面板不走终端，不认terminal.integrated.env.*，它直连插件进程 stdout - 解决方式分两步：
1. 在 settings.json 中为对应插件设置环境变量（以 Python 为例）：
"python.defaultInterpreterPath": "./venv/Scripts/python.exe",
"python.envFile": "${workspaceFolder}/.env"
2. 在项目根目录创建 .env 文件，写入：
PYTHONIOENCODING=utf8 LANG=zh_CN.UTF-8
- 重启 VSCode 并重新加载窗口（
Developer: Reload Window） - 如果插件没读
.env（如旧版 Pylance），则需在插件文档里查其专用环境变量名，例如"python.languageServer": "Pylance"时，必须用python.defaultInterpreterPath指向一个已设好环境的 Python
最易被忽略的一点：插件市场的中文乱码只修字体还不够，若系统缺少 Noto Sans CJK SC 这类开源字体，即使写了 fallback 也白搭；而插件安装日志乱码表面看是路径问题，实则是整个 Node.js 子进程链在 Windows 上对 UTF-8 路径的原生支持残缺——这两类问题根源完全不同，混在一起调配置只会越弄越乱。
