atom中go语言跳转函数定义需启用gopls语言服务器，ctrl+click实现跨文件跳转；当前文件内符号查找用ctrl+r（macos为cmd+r），仅限顶层符号且不支持嵌套函数。

Atom 里跳转函数定义，核心就两条路：当前文件用 Ctrl+R（macOS 是 Cmd+R），跨文件必须靠 gopls 或 ctags —— 没这两样，光按快捷键只是原地弹窗。

Ctrl+R 只查当前文件，别指望它跳到别的 .go 或 .ts 里

这个快捷键本质是读取当前文件的语法结构，不是全项目索引。它能列出 function hello()、class User、const API_URL 这类顶层符号，但点进去永远在同一个文件内滚动。

• 支持实时过滤：输 useE 就能筛出 useEffect，大小写不敏感
• 不识别嵌套函数：比如 function outer() { function inner() {} }，inner 不会出现在列表里
• 如果列表为空，先确认语言模式是否正确——右下角显示 JavaScript 而不是 Plain text

Go 项目必须开 gopls，否则 Ctrl+Click 是摆设

Go 语言的跳转不依赖 ctags，现代方式是靠 go-plus 插件集成的 gopls 语言服务器。没启用它，Ctrl+Click 函数名只会光标闪烁一下，毫无反应。

• 检查路径：Settings → Packages → go-plus → Settings，确保勾选了 Use Language Server (gopls)
• 如果 gopls 命令不在 $PATH，手动填绝对路径，例如 /home/you/go/bin/gopls
• 首次启用后要等几秒，右下角出现 gopls: ready 才算真正就绪；此时把光标停在 fmt.Println 上 Ctrl+Click，才会跳进 Go 标准库源码

其他语言（JS/TS/Python）得靠 ctags 文件，不是插件开了就行

symbols-view 插件本身不解析代码，它只读项目根目录下的 tags 文件。没这个文件，或者文件过期，Ctrl+Alt+Down 或 Ctrl+Shift+R 全部失效。

• 生成命令（Linux/macOS）：ctags -R --fields=+niaz --c-kinds=+p --c++-kinds=+p .，注意结尾是英文句点
• 必须叫 tags（全小写），不是 TAGS 或 mytags；文件得放在你用 File → Add Project Folder 添加的那个根目录下
• 改完代码后记得重跑 ctags，否则跳转会指向已删除或重命名的旧位置
• 符号树插件 symbols-tree-view 能直观展示嵌套关系，但它也依赖同一个 tags 文件

退回去比跳过去还容易出错

Atom 的“返回上一位置”分两套逻辑：Ctrl+Alt+Up 是 symbols-view 自己维护的跳转栈，只管符号跳转；而 Alt+Left 或右键菜单里的 “Go Back” 是编辑器通用导航历史，和符号无关。

• 用 Ctrl+R 或 Ctrl+Alt+Down 跳转后，唯一可靠返回方式就是 Ctrl+Alt+Up
• 如果连按多次 Ctrl+Alt+Up 没反应，说明跳转栈是空的——可能你根本没成功跳转，或者插件没加载
• 别依赖鼠标悬停提示，symbols-view 不提供 hover 预览，只有点击/回车才触发跳转

最常被忽略的一点：所有跨文件跳转能力都绑定在「项目根目录」这个物理路径上。加错文件夹、ctags 生成位置不对、gopls 工作区没识别到 go.mod，都会让跳转静默失败——它不会报错，只会什么都不做。