折叠箭头不显示或模糊的根本原因是 theme 缺失 fold_button 规则、font_options 启用 subpixel_antialias 导致图标失真、color scheme 未定义 fold_marker foreground；st4 推荐用 layer0.tint 绘制纯色矢量箭头，需编辑 .sublime-theme 文件并确保三者协同配置。
Sublime Text 默认的折叠箭头在高 DPI 屏幕或某些主题下容易模糊、错位甚至完全不可见，这不是 bug，而是 fold_button 渲染依赖 theme + font_options + color scheme 三者协同的结果；直接改设置文件无效，必须编辑 .sublime-theme 文件才能真正控制图标样式。
为什么折叠箭头不显示或变成方块？
常见现象包括：左侧 gutter 空白、点击无反应、箭头糊成一团、或显示为 Unicode 方块（）。根本原因不是插件冲突，而是以下三点中至少一项缺失：
-
theme文件里没定义"class": "fold_button"规则，或漏了"layer0.tint"/"content_margin"等关键字段 - 启用了
"font_options": ["subpixel_antialias"]，在 2x DPI 屏上会让 12×12px 的 PNG 图标严重失真 -
color scheme没提供"fold_marker"的foreground，导致图标颜色透明（尤其暗色主题常忽略此项）
如何手动替换为清晰的纯色箭头（ST4 推荐方案）
Sublime Text 4 支持用 layer0.tint 直接绘制矢量级纯色箭头，比 PNG 更锐利、适配任意缩放。操作路径如下：
- 打开
Packages/User/YourTheme.sublime-theme（若无则复制Packages/Theme - Default/Default.sublime-theme并重命名） - 找到
"class": "fold_button"所在 rule（通常在"rules"数组中） - 确保它包含以下最小配置：
{ "class": "fold_button", "layer0.texture": null, "layer0.tint": [128, 128, 128, 255], "content_margin": [4, 4] } - 保存后重启 Sublime（v4.4+ 可热重载，但首次建议重启）
其中 [128, 128, 128, 255] 是灰度 RGBA，可按需改成 [100, 200, 255, 255] 等亮色，避免与背景混淆。
想用自定义 PNG 图标？注意三个硬限制
虽然支持 PNG，但 Sublime 对折叠图标的加载极其严格：
- 必须是 12×12 或 24×24 像素（高 DPI 下自动选 24×24），其他尺寸会被拉伸变形
- 路径必须写成相对路径：
"layer0.texture": "Theme - Default/fold.png"，不能用绝对路径或~/ - 图片必须放在
Packages/下对应目录内，且文件名不含空格或中文（否则静默失败）
更稳妥的做法是把 PNG 放进 Packages/User/，并在 theme 中引用 "layer0.texture": "User/fold.png"。
折叠箭头生效但颜色不对？检查 color scheme
即使 theme 配对了 fold_button，如果当前 color scheme 没声明 "fold_marker"，图标仍会透明。打开你正在用的 .sublime-color-scheme（如 Monokai.sublime-color-scheme），在 "globals" 或顶层加：
{
"name": "fold marker",
"scope": "fold_marker",
"settings": {
"foreground": "var(blue)"
}
}
其中 var(blue) 可替换为具体十六进制值如 "#6699CC"；若没生效，说明该 scheme 被插件覆盖，优先检查 Preferences → Settings – Syntax Specific 是否有冲突项。
真正难调的不是单个参数，而是 theme、color scheme、font_options 三者之间的隐式耦合——改完一个，往往要连带验证另两个是否还兼容。建议每次只动一处，保存后立刻测试折叠按钮是否出现、点击是否响应、缩放时是否清晰。
