“文件不存在”提示主因是Sublime未索引该目录，需确认项目已通过Project→Add Folder to Project显式加载、.sublime-project路径配置合法且UTF-8编码、保存文件后执行Reload Project刷新配置。
跳转提示“文件不存在”，大概率不是路径写错了，而是 Sublime 根本没索引到那个目录——它压根不知道文件在哪儿。
Ctrl+P 搜不到新添加的文件？检查项目是否真正加载
Sublime 的 Ctrl+P（Windows/Linux）或 Cmd+P（macOS）只搜已加入项目的目录，双击打开单个文件或拖拽进窗口不会自动建立项目上下文。
- 确认你已通过 Project → Add Folder to Project… 显式添加了父文件夹（比如
src或整个my-app） - 如果只是用菜单 File → Open File… 打开一个 .py 文件，
Ctrl+P默认只搜当前标签页，不会跨目录 - 刚添加大文件夹后首次使用
Ctrl+P会卡顿 2–5 秒，状态栏显示Indexing…，等它消失再试 - 右下角语言模式必须是具体语言（如
Python），不能是Plain Text，否则符号和路径解析器不启动
侧边栏空了、文件变灰、跳转失效？验证 folders 配置有效性
.sublime-project 文件里 folders 字段一旦格式错误或路径不可达，Sublime 会静默忽略整条记录，不报错也不提醒。
- 用 VS Code 或记事本打开
.sublime-project，确认folders是数组，每个元素含"path"字符串，例如：[{"path": "src"}, {"path": "../shared"}] - Windows 下避免单反斜杠：
"path": "D:myproj"是非法 JSON（m被转义），应写成"path": "D:/myproj"或"path": "D:\myproj" - 路径不能以
./开头；"path": "./src"无效，"path": "src"才是相对于项目文件的合法相对路径 - 运行
ls -la src（macOS/Linux）或dir src（Windows）确认目录真实存在且无权限拒绝
刚保存的文件还是搜不到？索引未覆盖未保存内容
Sublime 的项目索引只包含已保存的文件内容，未保存的修改（哪怕只差一次 Ctrl+S）不会进入 Ctrl+P 或 @xxx 的匹配范围。
-
Ctrl+P @my_func搜不到刚写的函数？先按Ctrl+S保存当前文件 -
Ctrl+R在单文件内列不出新函数？同样需先保存，否则symbol_list不更新 - 点号开头文件（如
.env、.gitignore）默认被file_exclude_patterns排除，可在 Preferences → Settings 中临时注释掉相关规则测试
路径含中文或空格后跳转失败？编码与配置要对齐
中文路径本身不导致崩溃，但若 .sublime-project 文件未保存为 UTF-8，或 Sublime 未启用 Unicode 支持，就会解析失败。
- 确保
.sublime-project文件用 UTF-8 编码保存（VS Code 默认就是，记事本需另存为时选 UTF-8） - 在用户设置中确认启用了
"enable_unicode_paths": true - 路径含空格无需额外转义，但避免使用特殊 shell 字符（如
$、`、(） - 符号链接（symlink）需单独验证目标可达：
readlink -f path（Linux/macOS）或dir /a:l（Windows）
最常被忽略的一点：Sublime 不会主动重载项目配置。改完 .sublime-project 或删了无效 folders 条目后，必须手动执行 Project → Reload Project，否则所有修复都白做。
