f12/ctrl+click跳不到定义是因sublime原生无语义解析，必须分层排查：先确认语法识别（右下角非plain text）、文件已保存、项目通过add folder to project加载；再检查索引是否就绪；最后配置lsp或ctags实现精准跳转。
F12 或 Ctrl+Click 跳不到定义，不是快捷键坏了，是 Sublime 原生不解析语义——必须分层排查：先确保符号能被识别，再确认索引已就位，最后才轮到语言服务器。
Ctrl+R 空白或搜不到函数？先救语法识别和保存状态
Ctrl+R（Windows/Linux）或 Cmd+R（macOS）调出的是当前文件的 symbol_list，它不查 AST，只靠语法高亮规则里的正则提取。常见失效点：
- 右下角显示
Plain Text？点它手动选成Python或JavaScript，否则解析器压根不启动 - 刚写完
def my_func():就按 Ctrl+R 搜不到？先按Ctrl+S保存，未保存内容不进索引 - Python 中
_helper()不出现？这是语法定义默认过滤下划线开头符号，不是 bug - JS 中
const fn = () => {}或obj.method = function() {}不见？原生只认function fn() {}和class Foo { method() {} }
Ctrl+P @xxx 总没结果？检查项目索引是否真正就绪
Ctrl+P @my_function 是最稳的跨文件跳转入口，但它不实时扫描，依赖后台建好的索引。失败主因不是插件没装，而是基础条件缺位：
- 必须通过
Project → Add Folder to Project添加整个项目根目录；单文件打开时@搜索基本无效 - 首次添加后等右下角
Indexing…消失再输，否则符号表为空 - .sublime-project 文件里检查
"index_files": true——默认开启，但有人为提速手动关过 - 输入格式必须是
@my_function，不能是my_function@或my_function() - 输
utils.py@parse_config可直跳指定文件中的定义行，比模糊搜更准
F12 / Ctrl+Click 仍跳错？说明你还没启用语义解析能力
F12 触发的是 goto_definition 命令，但 Sublime 原生不实现它——实际由插件接管。跳到 import 行、__init__.py 或 site-packages，不是配置错，是链路断在解析层：
- 原生只做字符串匹配：看到
requests.get，就去搜def get，大概率先命中from requests import get - 对装饰器包裹（如
@cache）、getattr动态构造、无类型提示的函数完全无响应 - 想让它真正工作，必须装
SublimeLSP+ 对应语言服务器（如python-lsp-server、typescript-language-server） - 服务器二进制必须已安装；Python 项目需有
pyproject.toml（哪怕只有[tool]）；状态栏出现LSP: ready才算生效 - 跳进
typeshedstub 而非真实.py？在 LSP 设置里加"plugins": {"jedi": {"enabled": false}}
离线或轻量场景下，CTags 是唯一兜底方案
它不联网、不依赖 Python 环境、不启动后台进程，适合资源受限或无法配 LSP 的场景，但得接受它的机械性：
- 在项目根目录运行：
ctags -R .（macOS/Linux）或ctags -R --fields=+nia .（Windows 推荐加字段参数） -
tags文件必须和项目根同级，且 Sublime 已加载该文件夹为项目 - 右键函数名选
Goto Definition，或查插件文档绑定快捷键 - 缺点明显：漏掉
exec/eval、不处理别名导入（import numpy as np后点np.array无效）、不支持类型提示推导
真正卡住人的从来不是“怎么装插件”，而是忽略“项目必须通过 Add Folder to Project 加载”“文件必须已保存”“右下角语言模式必须正确”这三个硬前提——它们不报错，但会让所有后续配置归零。LSP 再强，也跳不过一个没索引的空项目。
