直接改Settings无效，因Sublime Text不识别sidebar_icons等键名，图标渲染完全由.sublime-theme文件驱动；需用PackageResourceViewer提取主题、修改icon_folder规则的layer0.texture路径并确保PNG尺寸合规，或通过A File Icon插件映射内置图标名。
为什么直接改 Settings 里的 sidebar_icons 没反应
因为 Sublime Text 根本不识别 sidebar_icons、show_folder_icons 这类键名。侧边栏图标渲染完全由当前启用的 .sublime-theme 文件控制，Settings 只管缩进、字体、保存行为等通用逻辑，不参与图标绘制。
常见错误包括：在 Preferences → Settings – User 里手动加 "file_icons": true 后期待文件夹图标出现——这只能激活 A File Icon 插件对「文件后缀」的小图标支持，对文件夹本身无效；或者以为换配色方案（color_scheme）能影响图标颜色，其实它只作用于编辑区文字高亮。
如何安全修改 .sublime-theme 文件
别硬改 Packages/Theme - Default/Default.sublime-theme，升级后会被覆盖。正确做法是用 PackageResourceViewer 提取后另存为自定义主题：
- 装好
PackageResourceViewer，按Ctrl+Shift+P→ 输入PackageResourceViewer: Open Resource→ 选当前主题（如Theme - Default → Adaptive.sublime-theme） - 搜索
"class": "icon_folder"或"class": "icon_file_type"，找到对应规则块 - 复制整条规则，在
Packages/User/MyIcons.sublime-theme中新建文件并粘贴（注意后缀必须是.sublime-theme） -
layer0.texture字段填相对路径，例如"MyIcons/folder-closed.png"，不是文件名也不是绝对路径 - 确保 PNG 尺寸为
16×16或32×32，且放在Packages/User/MyIcons/目录下 - 改完保存，按
Ctrl+Shift+P→UI: Reload Theme实时预览，不用重启
A File Icon 的 file_icons 映射怎么写才生效
这个映射只对「文件后缀图标」起作用，且必须绑定到插件内置的图标标识符上，不能随便写字符串：
- 冷门后缀如
.env、.toml默认无图标，需在Preferences → Package Settings → A File Icon → Settings – User中添加：
{
"file_icons": {
".env": "dotfile",
".toml": "config",
".ts": "typescript"
}
}-
"dotfile"和"config"是 A File Icon 内置的合法图标名，写错一个字符就 fallback 成空白文档图标 - 改完保存后执行命令面板里的
A File Icon: Rebuild Icons，新增映射必须重启 Sublime 才能加载 - 如果用了 Material Theme，它自带的图标映射优先级更高，可能覆盖你的配置；此时可显式加
"material_theme_file_icons": true并确认主题资源完整
改图标时最容易被忽略的三个细节
很多失败不是语法错，而是被这些隐性约束卡住：
-
.sublime-theme只认PNG，不支持.svg或.ico—— 即使声明了矢量支持，实际渲染仍走 PNG 回退路径 -
layer0.opacity默认常为0.8或更低，导致新图标发灰；务必设成1.0才能看清原色 - 某些主题（如
Origami）把文件夹展开箭头和图标写在同一 rule 里，动错class名或删掉某层layer，整个侧边栏图标会消失
真正要换图标，得同时满足：主题文件定义了对应 class、PNG 路径正确、尺寸合规、opacity 和 tint 不干扰——缺一不可。
