BetterFindBuffer需手动配置才生效：必须加载项目、完全重启Sublime、确认菜单存在；颜色方案需在Packages/User下放对文件并严格命名；禁用原生装饰项才能优化UI。
BetterFindBuffer 不是“美化插件”，它本质是重写查找结果缓冲区的行为逻辑；直接装上不会自动变好看，必须手动配颜色方案和设置项才能生效。
安装后功能不出现？先确认是否满足三个硬性前提
插件装完不生效，90% 是卡在这三步没做：
- Sublime Text 必须已加载项目（左下角状态栏显示类似
~/my-project/的路径），仅打开单个文件时Ctrl+Shift+F结果页压根不会触发 BetterFindBuffer 的 UI 逻辑 - 安装后必须完全退出 Sublime Text 再重启，不是关闭标签页——Python 插件模块只在启动时加载一次
- 检查
Preferences → Package Settings → BetterFindBuffer是否存在；若菜单里没有，说明插件未正确解压到Packages/BetterFindBuffer/目录（Linux/macOS 路径通常是~/.config/sublime-text-3/Packages/）
自定义颜色方案为什么无效？路径和配置必须同时对
默认的查找结果页用的是 Sublime 原生主题，BetterFindBuffer 不会覆盖它。要换色，得自己建两个文件：
- 把官方推荐的
Custom_FindResults.hidden-tmTheme文件（或你改好的主题）放进Packages/User/目录 - 在同目录下新建
Find Results.sublime-settings，内容必须严格为：{ "color_scheme": "Packages/User/Custom_FindResults.hidden-tmTheme" } - 注意：文件名必须是
Find Results.sublime-settings，不能写成find_results.sublime-settings或带空格/大小写偏差——Sublime 对文件名大小写敏感
想让查找结果页更干净？关掉原生干扰项
BetterFindBuffer 的 UI 优化依赖禁用 Sublime 自带的装饰元素，否则会出现双行号、重复缩进线等错位：
- 在
Find Results.sublime-settings里追加："line_numbers": false, "draw_indent_guides": false, "fold_buttons": false, "highlight_line": false
- 别动
Preferences → Settings – User里的全局设置，这些只影响普通编辑器视图，对查找结果页无效 - 如果结果页仍显示右键菜单里的“Copy File Path”等原生项，说明 BetterFindBuffer 的命令绑定失败——检查是否有其他插件（如 SideBarEnhancements）劫持了
ctrl+alt+o等快捷键
真正起效的关键点就一个：Find Results.sublime-settings 这个文件必须存在、路径精确、JSON 格式无误，且 Sublime 是冷启动加载的。少一个条件，颜色和 UI 都白配。
