F12跳转常失效因Sublime原生仅靠正则匹配、无语义分析；需配LSP+pylsp实现精准跨文件跳转，或用Universal Ctags作离线替代。
Sublime 的 F12 跳转为什么经常失效？
F12 默认触发 goto_definition 命令，但 Sublime 原生不解析语义，只靠正则匹配符号和简单索引——这意味着它根本不知道 my_func 是定义在 utils.py 还是 core/__init__.py。常见失效现象包括：按 F12 没反应、跳到错误位置、仅限当前文件内跳转、Python 中跨模块导入后完全失灵。
根本原因有两个：没建立项目级符号索引，或语言本身动态性太强（如 Python 的 from module import *、运行时 patch）导致静态分析失败。单纯指望原生功能，在中大型项目里基本等于放弃导航。
Python 项目必须配 LSP + pylsp 才能真正用好 F12
这是目前最稳定、精度最高、维护最活跃的方案。LSP 不依赖 Sublime 自己的索引，而是调用专业的语言服务器（如 pylsp），实时分析 AST 和 import 链路。
- 先通过 Package Control 安装
LSP插件 - 终端执行：
pip install python-lsp-server（推荐）或pip install pylsp - 重启 Sublime，打开一个
.py文件，状态栏右下角应显示LSP-pylsp - 把光标停在任意函数名上，按
F12—— 现在它真能跳进requests.get或你自己写的parse_config()里了
注意：pylsp 默认不识别 src/ 目录或 setup.py 定义的模块路径。若跳转失败，需在项目根目录建 .pylsp.yaml，加一行：plugins: {jedi_completion: {enabled: true}}，并确保 PYTHONPATH 正确。
不用 LSP？CTags 是唯一靠谱的离线替代方案
适合无法联网、禁用 Python 后端、或需要极致启动速度的场景（比如嵌入式 C/C++ 项目）。它不依赖语言服务器，纯静态索引，但精度取决于 ctags 生成质量。
- 安装
Universal Ctags（不是老旧的 Exuberant）：brew install universal-ctags（macOS）或从 GitHub releases 下载二进制 - 项目根目录运行：
ctags -R --languages=python,javascript,typescript . - 用 Package Control 安装
CTags插件（注意不是SublimeCTags） - 重启 Sublime，右键函数名 →
Goto Definition，或按Ctrl+Shift+Click
坑点：Python 中 @property、__getattr__、装饰器包裹的函数，ctags 很可能漏掉；JavaScript 的 ES6 模块、动态 import() 也常失效。别对它要求“100% 准确”。
快捷键和命令面板里的隐藏细节
F12 不是唯一入口，且可被覆盖。很多用户装了插件却仍用不好，是因为没理清命令来源：
-
F12默认绑定的是原生goto_definition，但 LSP 插件会劫持该命令，实际执行的是lsp_symbol_definition - 想确认当前生效的是哪个命令？按
Ctrl+Shift+P→ 输入goto definition，看列表里高亮的是哪个 - 自定义快捷键时，务必写全命令名：
{"keys": ["ctrl+g"], "command": "lsp_symbol_definition"}（LSP 启用后）或{"keys": ["ctrl+g"], "command": "goto_definition"}（原生） - 右键菜单中的
Go to Definition项，行为与 F12 完全一致，只是触发方式不同
最容易被忽略的一点：F12 跳转后，按 Alt+- 可退回上一位置——这比鼠标点返回箭头快得多，但几乎没人记得用。
