黑边问题根源在于 local/state 缓存、directwrite 渲染、主题残留及 dpi 缩放适配缺失，需依次删除 state 文件夹、设置 font_options: ["gdi"]、清理 user 下 .sublime-theme 文件，并选用支持 scale_factor 的新版主题。
主题渲染缓存锁死导致黑边，必须删 Local/State 而非 Cache
界面出现黑边（尤其是侧边栏、标签页或状态栏边缘）不是主题文件坏了，而是 Sublime Text 把 UI 渲染状态固化在 Local/State 里了——它记录了窗口缩放比例、DPI 缩放开关、UI 元素尺寸缓存，一旦和当前主题或系统 DPI 不匹配，就会渲染错位出黑边。只清 Cache 没用，Local/State 才是元凶。
- 先彻底退出 Sublime：Windows 任务管理器查
sublime_text.exe，macOS 活动监视器查Sublime Text，Linux 执行pkill -f "sublime_text" - 进入用户数据目录：
Windows：%APPDATA%\Sublime Text\Local\State
macOS：~/Library/Application Support/Sublime Text/Local/State
Linux：~/.config/sublime-text/Local/State - 删掉整个
State文件夹（不是里面某个文件，是整个文件夹） - 重启 Sublime，首次启动会重建 UI 状态，黑边通常消失
font_options: ["gdi"] 强制禁用 DirectWrite 是 Windows 黑边的根治方案
Windows 上黑边常伴随菜单繁体字、字体发虚、图标错位，本质是 DirectWrite 渲染引擎强行用系统默认中文字体（如微软雅黑）去套主题 UI 元素，但主题没适配其字形边界。改主题配置无效，必须切换底层渲染模式。
- 打开
Preferences → Settings，编辑右侧Preferences.sublime-settings - User - 加入这两行（注意逗号结尾，JSON 格式）：
"font_options": ["gdi"],"theme_font_options": ["gdi"] - 保存后必须完全退出 Sublime（关所有窗口 + 右键托盘退出），再重开——仅 Ctrl+Q 或 Cmd+W 不够，后台进程仍在用旧渲染上下文
主题文件残留导致黑边复现，要连带清理 Packages/User 下的 .sublime-theme
手动安装过主题后卸载不干净，Packages/User/xxx.sublime-theme 文件还在，而 Package Control 安装的新版主题又在 Packages/Theme - xxx/ 下，两个同名主题冲突时 Sublime 会随机加载一个，UI 尺寸计算错乱直接出黑边。
- 打开
Preferences → Browse Packages，进入弹出的Packages目录 - 检查
User/文件夹下是否有.sublime-theme文件（比如Dracula.sublime-theme），有就删掉 - 确认
Installed Packages/里没有重复的主题包（如Theme - Dracula.sublime-package和Dracula.sublime-package同时存在） - 重启后重新用 Package Control 安装主题，别拖文件进 User 目录
黑边只出现在高 DPI 屏幕？检查 theme 的 scale_factor 设置
部分主题（尤其老版本 Dracula、Material Theme）硬编码了 UI 元素像素尺寸，没适配 125% / 150% DPI 缩放，结果按钮拉伸、背景图平铺错位，边缘留黑。这不是缓存问题，是主题本身缺陷。
- 打开主题文件夹（如
Packages/Theme - Dracula/），找xxx.sublime-theme文件 - 搜索
"scale_factor"或"dpi_scale"，若没找到，说明该主题不支持动态缩放 - 临时解法：在用户设置里加
"dpi_scale": 1.0强制禁用系统 DPI 缩放（会变小但无黑边） - 长期解法：换新版主题（如
Theme - Spacegray或ayu），它们明确声明支持scale_factor
黑边问题最易被忽略的是 Local/State 和 DPI 缩放逻辑的耦合——删缓存不删 State，或者开了 font_options: ["gdi"] 却没彻底退出进程，都会让修复失效。
