vscode高分屏模糊源于系统缩放与electron渲染未对齐，需先设为windows推荐缩放值（如125%、150%），再通过--force-device-scale-factor=整数、禁用硬件加速、运行cleartype向导、安装fira code等现代字体并正确配置fontfamily解决。
VSCode在Windows高分屏上显示模糊，根本不是字体或主题的问题，而是系统缩放值（如125%、150%）与Electron渲染引擎之间没对齐——它会用非整数倍拉伸UI和文字，直接导致锯齿、发虚、边缘晕染。
确认并锁定系统推荐缩放值
很多模糊问题其实源于系统自己“猜错”了缩放比例。Windows会根据显示器物理尺寸+分辨率计算一个(推荐)值，这个值才真正匹配子像素排布和ClearType路径。
- 右键桌面 →「显示设置」→「缩放与布局」→ 查看下拉菜单中标有(推荐)的选项（常见为100%、125%、150%、200%，但绝不是110%或133%这种非标准值）
- 如果当前不是推荐值，先切过去，**重启VSCode**观察是否改善；若已是最优值但仍有模糊，说明问题出在渲染链路，继续往下调
- 别手动输
window.zoomLevel去“补救”——它和系统缩放叠加后只会让模糊更严重
强制VSCode走整数缩放渲染路径
Electron默认启用自动DPI适配，但在某些驱动或缩放组合下会选错渲染策略。--force-device-scale-factor能绕过它的猜测，直接指定缩放因子。
Windows TTS (WSL2)
下载
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
- 该参数必须是整数：
1（对应100%）、1.5（对应150%）、2（对应200%），不能写1.25——它不支持小数点后一位以外的精度 - 使用方式：修改VSCode快捷方式目标栏，在原路径后加空格再加
--force-device-scale-factor=1.5（以150%为例） -
禁用
window.zoomLevel：两者不可共存，否则缩放被应用两次，文字会被二次插值，糊得更彻底
关闭硬件加速并校准ClearType
GPU加速在部分Intel核显或旧NVIDIA驱动下，会把字体光栅化交给质量较差的合成器处理，CPU软渲染反而更稳。
- 永久关闭：VSCode设置中搜索
disableHardwareAcceleration，勾选该项（对应配置项为"disableHardwareAcceleration": true） - 临时验证：命令行启动
code --disable-gpu，如果终端/编辑器文字立刻变锐利，就坐实是GPU渲染路径问题 - 运行系统
ClearType向导：开始菜单搜“调整 ClearType 文字”，全程选最清晰的一行，**必须做完五组**，跳过会导致子像素渲染未激活
换掉Consolas，装Fira Code或Cascadia Code
Consolas在非100%缩放下极度依赖ClearType子像素渲染，一旦系统没配好或缩放非整数，它第一个糊。而Fira Code、Cascadia Code等现代编程字体自带hinting指令和更鲁棒的抗锯齿轮廓。
- 字体必须先安装到系统：双击
.ttf文件 →「安装」，不能只改editor.fontFamily配置却不装字体文件 - VSCode设置中写法：
"editor.fontFamily": "Fira Code, Consolas, 'Courier New', monospace"（注意引号和英文逗号） - 终端也要单独配：
"terminal.integrated.fontFamily": "Cascadia Code"，编辑器和终端字体不同步时，复制粘贴容易误判语法结构
真正卡住人的地方，往往不是某一项没调，而是几处设置互相冲突：比如一边用--force-device-scale-factor=1.5，一边又开了window.zoomLevel: 0.2；或者ClearType向导只做了三页就跳过；又或者字体名字写了但没真安装。这些细节不抠清楚，调十次也还是糊。
