Sublime Text原生跳转依赖符号索引，失效主因是索引未建好、语法识别错误（如右下角显示Plain Text）或未添加项目文件夹；需先保存文件、正确设置语言类型、通过Project→Add Folder to Project添加根目录并等待索引完成。
Sublime Text 原生不解析 AST，所有“跳转到定义”行为都依赖符号索引 —— 索引没建好、类型没识别、配置关掉了，goto_definition 就必然失效。别折腾插件顺序，先确认这三件事是否就位。
Ctrl+R 为什么空着不显示函数？
它不是“搜函数”，是读当前文件的 symbol_list；这个列表由语法高亮规则生成，跟代码是否合法无关，只跟右下角语言标识有关。
- 右下角显示
Plain Text？点它手动选成Python或JavaScript，否则解析器压根不启动 -
def func():可见，但func = lambda x: x或functools.partial(...)不会进列表 - JS 中
function render() {}和class Foo { method() {} }可识别；const fn = () => {}和obj.fn = function() {}基本不可见 - 未保存的文件可能不触发重建：先按
Ctrl+S，再试Ctrl+R
跨文件跳转为什么总跳错或没反应？
F12 和 Ctrl+Click 背后调用的是 goto_definition 命令，它默认只查已索引的符号，而 Sublime 默认不自动索引项目 —— 你得显式告诉它“要建索引”。
- 必须通过
Project → Add Folder to Project打开整个目录，单文件模式下跨文件跳转基本瘫痪 - 首次添加后等右下角 “
Indexing…” 消失，否则符号表为空 - 检查项目配置：
.sublime-project文件里必须有"index_files": true（默认开启，但有人为提速手动关过） -
Ctrl+P @my_function是项目级搜索入口，但输入格式必须是@my_function，不能是my_function@或my_function()
为什么 LSP 跳不到 requests.get？
LSP 本身能处理第三方库，但 Pyright / pylsp 这类服务器需要明确知道“哪些路径算你的源码”，否则默认只在当前工作区和 site-packages 的 stubs 里找。
- Pyright 要求项目根目录存在
pyproject.toml（哪怕只有[tool]也行），否则退化为语法级匹配 - 想跳进真实
.py文件而非.pyi，需在 LSP 设置中加"python.analysis.extraPaths": ["path/to/site-packages"] - 状态栏没出现 LSP 图标、命令面板搜不到
Go to Definition、Console 报Failed to start language server—— 都说明服务器根本没起来 - 用
subl .从激活的虚拟环境目录启动 Sublime，比双击图标更可靠，能避免PYTHONPATH错乱
CTags 是最稳的备选方案，但它漏什么？
它不依赖网络、不启动后台进程、不看 Python 环境，靠本地 tags 文件查表 —— 适合老旧项目、CI 环境或 LSP 配不好的场景。但动态代码就是它的盲区。
- 运行
ctags -R --python-kinds=+i --exclude=.git --exclude=__pycache__ .生成索引，注意用universal-ctags，不是系统自带的老版 - Sublime 安装
CTags插件后，首次使用前右键项目根目录 →CTags: Rebuild Tags - 支持
Ctrl+Alt+Click和Ctrl+Shift+T查调用处，但对getattr(obj, "load")、@cache包裹函数、obj.__getattribute__完全无响应 - 不会区分同名函数作用域：
User.save和Post.save都叫save，结果混在一起列出来
真正容易被忽略的起点，不是插件装没装，而是右下角那个语言标识 —— 它错了，后面所有跳转逻辑都建立在流沙上。
