Sublime Text 文件跳转失效主因是索引未建好、语言模式错误或文件未加入项目；需确保通过“Add Folder to Project”添加目录、右下角设为具体语言、文件已保存，且等待Indexing完成。
Sublime Text 无法跳转文件，不是快捷键坏了，也不是你装错了插件——绝大多数情况是符号索引没建好、语言模式不对、或文件根本没进项目上下文。
Ctrl+P @xxx 不生效？先看这三件事
这是 Sublime 原生最稳的跨文件跳转方式，但依赖项目级索引和语言识别：
- 项目必须通过
Project → Add Folder to Project添加根目录；单文件打开时@xxx基本无效 - 右下角语言模式必须是具体语言（如
Python），不能是Plain Text；否则符号不被解析 - 文件必须已保存——未保存内容不会进索引，
@parse_config搜不到刚写的函数定义 - 首次在大项目中使用会卡顿 2–5 秒，状态栏显示
Indexing…，等它消失再输 - 输入格式要严格：
@render（开头带 @）→ 匹配所有含该符号的定义行；utils.py@parse_config→ 直接打开并跳到定义位置
F12 / Ctrl+Click 跳到 import 行？说明没语言服务器
F12 触发的是 goto_definition 命令，但 Sublime 原生不实现语义分析，只做文本匹配。常见表现包括：
- 跳到
import requests行，而非requests.get的真实定义 - Python 中跳进
site-packages或__init__.py，而不是你本地写的源码 - JS/TS 中跳进
node_modules的类型声明，而非业务代码 - 对装饰器包裹、
getattr动态构造、无类型提示的函数完全无响应
真正解决需装 SublimeLSP + 对应语言服务器（如 pylsp、typescript-language-server），并确认状态栏左下角显示 LSP-pylsp 或 TS Server。
中文插件导致跳转失效？改一个菜单项就行
部分中文汉化插件会覆盖默认命令名，导致右键菜单里“转到定义”不可用：
- 路径：
~/Library/Application Support/Sublime Text/Packages/Default/Context.sublime-menu（macOS）或对应 Windows/Linux 路径 - 找到
"context_goto_definition"，替换成"goto_definition" - 重启 Sublime，右键函数名 → “转到定义” 就能用了
CTags 是唯一离线兜底方案，但别指望它懂 Python 的 @property
如果没法联网、禁用后台进程、或项目纯 C/C++，Universal Ctags 是目前最轻量可靠的替代：
- 安装：
brew install universal-ctags（macOS）或从 GitHub releases 下载二进制 - 项目根运行：
ctags -R --languages=python,javascript,typescript . - 用 Package Control 安装
CTags插件（注意不是SublimeCTags） - 右键函数名 →
Goto Definition，或按Ctrl+Shift+Click
但它只认字面符号：漏掉 @property、__getattr__、动态 import、ES6 模块别名——跳得机械，不等于跳得准。
最容易被忽略的是：跳转精度不取决于你按了几次 F12，而取决于当前文件是否属于项目、是否已保存、语言模式是否激活、以及索引是否完成。哪怕只错一个逗号（比如 Settings 文件里多加了逗号），整个配置就静默失效——它不会报错，只会退回默认行为。
