sublime text原生跳转失效主因是符号索引未建好、语法识别错误（如右下角显示plain text）、文件未保存、项目未添加根目录或index_files被关闭；需手动选对语言、保存文件、添加项目文件夹并等待indexing完成。
Ctrl+R 和 Ctrl+P+@ 是最常用、也最容易失效的两个原生跳转入口——它们不报错，但常为空或漏匹配，根本原因不是快捷键没按对，而是底层符号索引压根没建起来。
右下角显示 Plain Text？跳转链路从第一步就断了
Sublime 不会为 Plain Text 模式生成任何符号列表，Ctrl+R、Ctrl+P+@、甚至 F12 都会静默失败。这不是配置问题，是语法解析器根本没启动。
- 点右下角语言标识（默认是
Plain Text），手动选成Python、JavaScript或对应语言 - 确认文件已保存：
Ctrl+S后再试，未保存内容不参与索引重建 - Python 中
_private_func默认不出现在Ctrl+R列表里；JS 中const fn = () => {}也不被识别——这是语法包行为，非 bug
Ctrl+P+@ 搜索不到函数？检查索引是否就位
这个操作依赖项目级索引，不是实时扫描。输 @parse_config 却没结果，大概率是索引没建好或路径没纳入。
- 必须通过
Project → Add Folder to Project添加整个项目根目录，单文件打开模式下基本无效 - 首次添加后等右下角 “
Indexing…” 消失再操作，大项目卡顿 2–5 秒属正常 -
"index_files": true必须开启（默认开启，但有人为提速手动关过） - 输入格式必须是
@my_function，不能是my_function@或my_function()
F12 / Ctrl+Click 跳到 import 行？原生不理解语义
原生 goto_definition 命令只做字符串匹配，看到 requests.get 就去搜 def get，优先命中 from requests import get 这行，而不是源码里的真实实现。
- 别名无法推导：
import numpy as np后点np.array，不会跳进 NumPy 源码 - 装饰器包裹的函数（如
@cache）会被解析成装饰器返回值，不是原始def行 - 动态访问完全失效：
getattr(obj, 'load')、obj.__getattribute__('load')零支持 - 第三方库跳转需 LSP +
pyproject.toml（哪怕只有[tool]）才能启用模块解析
LSP 是唯一能跨文件精准跳转的方案，但配置卡点很具体
它把语义分析交给外部语言服务器（如 pylsp、pyright），Sublime 只做协议桥接。装完插件 ≠ 自动生效，关键路径必须对齐。
- 状态栏没出现
LSP: ready？说明服务器根本没起来：查 Console 是否报Failed to start language server - Python 用户必须确保
subl .是从虚拟环境根目录启动，否则PYTHONPATH错位 - Pyright 需要项目存在
pyproject.toml或setup.py才能 resolve 第三方包（比如requests.get） - JS/TS 项目若跳不到
node_modules外的本地实现，先确认jsconfig.json或tsconfig.json是否存在且路径正确
