跳转不准的根源是符号索引不准、不全或被干扰，主因有三：索引范围过宽、语法识别错位（如显示plain text）、symbol_list规则不支持当前写法；需检查语言标识、保存文件、重建索引，并排除node_modules等冗余目录。
跳转不准不是插件没装对，是符号索引建得不准、不全或被干扰了。核心问题就三个：索引范围太宽（扫了不该扫的目录）、语法识别错位（右下角显示 Plain Text）、symbol_list 规则本身不支持你的写法。
为什么 @my_func 跳到错误文件或根本没结果？
Sublime 的 @ 搜索依赖项目级索引，不是实时 grep。它从已建好的符号表里模糊匹配，一旦索引路径错了、文件被排除了、或解析器压根没启动，结果就不可靠。
- 检查右下角语言标识是否为正确语法（如
Python，不是Plain Text）；点它手动切换 - 确认文件已保存：
Ctrl+S后再试，未保存内容不参与索引更新 - 打开命令面板（
Ctrl+Shift+P），输入Index Files: Rebuild Index主动触发重建，别等自动完成 - 若状态栏长期卡在
Indexing…，说明有大目录拖慢进度（比如node_modules或__pycache__）
如何精准控制索引范围，避免扫到垃圾文件？
默认索引会遍历整个项目文件夹，但 node_modules、.git、dist 这些目录既不包含源码，又严重拖慢解析速度，还污染符号列表。
- 用
Project → Save Project As…创建.sublime-project文件 - 在
"folders"下添加"folder_exclude_patterns": ["node_modules", "__pycache__", ".git", "dist", "build"] - 大小写敏感，Windows 下也必须写小写
- 可额外加
"index_exclude_patterns": ["*.min.js", "*.d.ts"]避免解析压缩/声明文件 - 改完保存，再执行
Index Files: Rebuild Index
哪些函数注定进不了索引？别白等
Sublime 原生不解析 AST，只靠语法包定义的 symbol_list 规则做文本提取。以下写法无论怎么调设置都不会出现在 Ctrl+R 或 @ 列表里：
- Python：
lambda x: x、functools.partial(func, ...)、getattr(obj, "method") - JavaScript：
const fn = () => {}、obj.method = function() {}、export default () => {} - TypeScript：
interface中的方法声明、class A { [computed]() {} } - 所有动态生成的符号：
require.context、eval、字符串拼接的函数名
遇到这些，直接用 Ctrl+Shift+F 配正则搜更实在，比如 JS 里搜 function\s+myFunc\b 或 const\s+myFunc\s*=\s*\(\)。
CTags 跳转比原生更稳，但配置细节容易漏
CTags 不依赖 Sublime 的索引机制，靠本地 tags 文件查表，适合老旧项目或 CI 环境，但对生成参数和文件位置极其敏感。
-
tags文件必须放在项目根目录，且无后缀（不能叫tags.txt） - 生成时必须带
--fields=+niaz（Sublime 插件依赖access和signature字段） - C++ 项目要加
--c++-kinds=+p，Python 推荐用ptags替代原生 ctags（原生对 Python 支持极弱） - Windows 下若用 Git Bash 生成，注意 BOM 问题；建议加
--utf-8参数 - 插件启用后需重启 Sublime，且当前视图必须已保存（未保存的临时文件无法解析）
最常被忽略的是：Sublime 不监听文件系统变化，tags 文件不会自动更新。每次改完代码，得手动按 Ctrl+Shift+P 输入 CTags: Rebuild Tags。
