插件市场中文显示为方块或空白是字体fallback失败所致，需在settings.json中配置"editor.fontFamily": "'Microsoft YaHei','SimSun','PingFang SC','Noto Sans CJK SC','monospace'"并彻底重启VSCode；Output面板乱码则因Node.js子进程未启用UTF-8，须设系统级环境变量NODE_OPTIONS=--experimental-utf8或改用纯英文工作区路径。
插件市场中文显示为方块或空白，不是编码问题而是字体 fallback 失败
VSCode 插件市场（Extensions Marketplace）页面里作者名、描述、标签等中文变成“□□□”或直接空白，右键检查元素能看到 DOM 中文本是正常的 UTF-8 字符，说明内容传输和解析都没问题——问题出在 Chromium 渲染层找不到可用的中文字体。它不读系统默认字体，只按 editor.fontFamily 配置的字体链顺序尝试渲染。
常见错误操作包括：只写 "SimSun"（Windows 上缺等宽变体，侧边栏文字易错位）、用中文名如“微软雅黑”（Chromium 忽略）、或漏掉单引号导致整个配置失效。
- 必须用英文标准字体名，按优先级从高到低排列：
"Microsoft YaHei"（Win）、"PingFang SC"（macOS）、"Noto Sans CJK SC"（Linux） - 每项用单引号包裹，逗号后带空格，结尾加
'monospace'保底 - 改完
settings.json后必须彻底重启 VSCode，仅重载窗口无效 - Linux 用户需确认已安装
fonts-wqy-zenhei或noto-fonts-cjk，DejaVu Sans不覆盖全部汉字
Output 面板中文全变成空格或 ，根源是 Node.js 子进程未启用 UTF-8
插件日志、语言服务器输出、调试通信内容出现在 Output 面板时乱码，和终端设置、files.encoding 完全无关。这是 VSCode 的 Extension Host 进程（基于 Node.js）在 Windows 下默认仍用 cp1252 解析 stdout，即使你设了 chcp 65001 也无影响。
-
terminal.integrated.env.windows中设NODE_OPTIONS对 Output 面板无效，那是给集成终端用的 - 真正起效的是系统级环境变量：
NODE_OPTIONS=--experimental-utf8（Node.js ≥18.17），或更兼容的--no-warnings --max-old-space-size=4096 - 若你开发插件，应在入口处加
process.stdout.setEncoding('utf8')，否则console.log('你好')可能被截断 - PowerShell 用户可临时验证：
node -e "console.log('你好')"，若乱码则确认 Node 版本与环境变量是否生效
插件配置项（如 code-runner.executorMap）里中文路径执行失败
在 settings.json 的插件配置中写 "c": "cd $dir && gcc ..."，而 $dir 含中文路径，cmd.exe 会按当前代码页（如 cp936）解码参数，导致 gcc 找不到文件——这不是 VSCode 的 bug，是 Windows 子进程 API 的固有缺陷。
- 不要指望插件自动转义或识别 UTF-8 路径；必须让 shell 在执行前就切到 UTF-8 模式
- cmd 场景：在命令前加
chcp 65001 >nul &&，例如"c": "chcp 65001 >nul && cd $dir && gcc ..." - PowerShell 更稳：用
powershell -Command "chcp 65001; cd '$dir'; ..."，避免 cmd 对单引号的转义问题 - 所有含中文的 JSON 配置文件本身必须用 UTF-8（无 BOM）保存，否则 VSCode 加载时就已损坏
插件安装日志报 ENOENT: no such file or directory 含中文路径
典型报错：Error: ENOENT: no such file or directory, mkdir 'D:\开发\ext'。这不是权限或路径不存在，而是 VSCode 调用 child_process.spawn 时，Node.js 在 Windows 下默认用系统代码页（GBK）解析传入的 UTF-8 字符串路径，造成字节错位。
- 唯一可靠解法：把工作区、VSCode 安装目录、甚至用户目录都移到纯英文路径下，例如
C:\vscode-workspace\ - 改系统区域设置启用“Beta 版：使用 Unicode UTF-8 提供全球语言支持”有一定帮助，但无法修复已有子进程调用链
- 插件打包的
.vsix文件若含中文文件名，解压时也可能失败；发布前应确保所有资源路径为 ASCII - 该问题与插件本身无关，任何调用
spawn的扩展（Python、C/C++、ESLint 等）都会触发
最常被忽略的一点：这些层（UI 渲染、Output 输出、配置解析、子进程路径）各自走不同的编码通道，改一个地方不能解决全部。必须按场景分别处理，且多数改动依赖重启或系统级生效，不能只靠重载窗口。
