Sublime索引功能莫名失效，index_files被自动设为false的原因及预防方法

问题重现 #

• 鼠标悬停跳转方法源码时返回结果不完整，手动移走索引文件夹后，Sublime未自动重建索引
• 查看「帮助>索引状态」无任何工作进程，也没有重新索引的迹象
• 打开偏好设置后发现"index_files": false，且确认未自行修改该配置项

可能的原因 #

1. 第三方插件篡改：部分代码导航、索引优化类的第三方插件，可能在更新或运行时为了临时禁用索引提升性能，悄悄修改全局偏好配置，且未提示用户。
2. Dev Build版本bug：你使用的Build 4169是开发版，这类版本可能存在配置写入的偶发bug，比如异常退出、版本更新后，错误覆盖了配置项。
3. 配置文件权限/损坏问题：Windows系统下，如果Sublime的Preferences.sublime-settings文件权限异常（比如被其他程序占用）或出现文件损坏，可能导致配置项被意外改写。

解决与预防办法 #

立即恢复索引功能 #

打开用户偏好设置（快捷键Ctrl+,），将"index_files": false修改为：

"index_files": true,

保存配置后重启Sublime，系统会自动开始重建索引。

排查插件问题 #

• 先临时禁用所有第三方插件，重启Sublime后观察配置是否还会被篡改
• 逐一启用插件，定位到触发问题的插件后，优先更新到最新版本；若问题依旧，考虑替换或卸载该插件

锁定关键配置 #

• 将"index_files": true放在配置文件的最末尾，避免被其他配置项的覆盖逻辑影响
• Windows系统下，可右键点击Preferences.sublime-settings文件，选择「属性>安全」，设置文件为只读（注意：后续手动修改配置时需要先取消只读权限）

切换稳定版Build #

如果频繁遇到此类问题，建议从开发版切换到Sublime Text的稳定版本，减少bug触发的概率

内容的提问来源于stack exchange，提问作者Tim Morton