sublime原生不支持语义级跳转，f12/ctrl+click仅文本匹配；可靠方式是ctrl+p @xxx（需项目添加、语言模式正确、文件已保存）；真正跳转需sublimelsp+语言服务器；ctags为离线兜底方案，但无语义理解。
Sublime 本身不支持“一键跳转到定义文件”——F12 或 Ctrl+Click 默认只做文本匹配，常跳到 import 行、头文件或空白处，不是你配置错了，是它原生就不解析语义。
Ctrl+P @xxx 是最稳的跨文件跳转入口
它不依赖插件，靠 Sublime 自带的项目索引，但必须满足几个硬性前提：
- 项目已通过
Project → Add Folder to Project添加根目录；单文件打开时@搜索基本无效 - 右下角语言模式必须是具体语言（如
Python），不能是Plain Text；否则符号不被识别 - 文件必须已保存——未保存内容不会进索引，
@parse_config搜不到刚写的def parse_config() - 首次在大项目中使用会卡顿 2–5 秒，状态栏显示
Indexing…，等它消失再输
输入格式要严格：@render（开头带 @）→ 匹配整个项目所有含该符号的定义行；utils.py@parse_config → 直接打开 utils.py 并跳到定义位置；@render 后按空格可切筛选模式，比如选 @ function 只列函数声明。
F12 跳不到？背后没服务，不是快捷键失效
F12 触发的是 goto_definition 命令，但 Sublime 原生不实现它——实际由插件接管。常见表现包括：
- 跳到
import xxx行，而非真实函数体 - Python 中跳进
site-packages或__init__.py，而不是你本地写的源码 - JS/TS 中跳进
node_modules的类型声明，而非业务代码 - 对装饰器包裹、
getattr动态构造、无类型提示的函数完全无响应
想让它真正工作，必须装 SublimeLSP + 对应语言服务器（如 pylsp、typescript-language-server），并确保服务器二进制已安装、PYTHONPATH 正确、"pylsp.plugins.rope.enabled": true 等关键开关已开。
CTags 是轻量跨文件跳转的兜底方案
它不联网、不启动后台进程、不依赖 Python 环境，适合离线或资源受限场景：
- 在项目根目录运行
ctags -R .（macOS/Linux）或ctags -R --fields=+nia .（Windows 推荐加字段参数） - 生成的
tags文件必须和项目根同级，且 Sublime 已加载该文件夹为项目 - 右键函数名选
Goto Definition，或用快捷键（默认未绑定，需查插件文档） - 缺点明显：漏掉动态代码（如
exec、eval）、无法处理别名导入、不支持类型提示推导
它能跳，但跳得“机械”——只认字面符号，不管语义是否真对应。
容易被忽略的细节：语法识别决定一切
所有跳转功能都卡在第一步：右下角是不是 Python、JavaScript 这类具体语言模式。一旦显示 Plain Text，Ctrl+R、Ctrl+P @、F12 全部失效。这不是 bug，是设计如此——Sublime 的 symbol_list 完全由语法高亮规则生成。比如：
- Python 中
_private_func默认不出现在Ctrl+R列表里，这是语法定义行为 - JS 中
const render = () => {}不被原生识别，得写成function render() {}或加/** @function */注释 -
.ts文件若被识别为Plain Text，@搜索就等于没开
跳转不准，八成不是插件没装对，是右下角那个小标签没点对。
