如何将 Sourcetrail 接入 Emacs安装 sourcetrail.el 并发送光标位置【免费下载链接】SourcetrailSourcetrail - free and open-source interactive source explorer项目地址: https://gitcode.com/GitHub_Trending/so/Sourcetrail这篇文章解决一个具体任务把 Sourcetrail 接入你正在使用的 Emacs安装sourcetrail.el插件后把 Emacs 光标所在的位置发送给 Sourcetrail让它在索引好的项目中定位到该处的符号。前提是 Sourcetrail 已安装并启动、目标项目已创建并完成索引插件发送位置后Sourcetrail 要展示的是该位置找到的所有符号这些符号来自索引数据。完成本文操作后你可以在 Emacs 中把光标停在某个符号上一条命令即可在 Sourcetrail 中查看它的依赖关系反向从 Sourcetrail 跳转回 Emacs 光标位置也是支持的文中作为可选分支说明。先了解双方的通信方式Sourcetrail 与各代码编辑器插件之间通过本地 TCP 连接通信见 DOCUMENTATION.md 的 Code Editor Plugins 一节Sourcetrail 使用端口6667监听插件发来的消息Sourcetrail 向插件发送消息时目标端口是6666这两个端口都可以在 Preferences Window 中修改对应的设置项分别是Sourcetrail PortPort number that Sourcetrail uses to listen for incoming messages from plugins和Plugin PortPort number that Sourcetrail sends outgoing messages to。消息格式为messageTypeparameter...EOM本场景涉及两条编辑器插件发给 Sourcetrail发送光标位置setActiveTokenabsolute/file_pathline_numbercolumn_numberEOMSourcetrail 发给编辑器设置编辑器光标moveCursorabsolute/file_pathline_numbercolumn_numberEOM其中fileLocation是目标文件的绝对路径。也就是说插件端必须能拿到当前缓冲区的绝对路径、行号和列号来组装这条消息。安装 sourcetrail.el 插件Sourcetrail 的官方文档DOCUMENTATION.md 的 Emacs 小节以及 ide_plugins/emacs/README.md 指向的插件仓库emacs-sourcetrail给出两条安装路径。路径一手动安装 sourcetrail.el文档主路径从官方插件仓库emacs-sourcetrail下载sourcetrail.el文件该仓库地址在 DOCUMENTATION.md Emacs 小节的 Repo 条目中本文按规范不直接给出外链。在 Emacs 中执行M-x输入package-install-file。输入刚才下载的sourcetrail.el文件的完整路径。这里的路径是你必须提供的值它取决于你上一步把文件保存到了哪里。路径二通过 Melpa 安装可选分支把 Melpa 加入 Emacs 的package-archives。按M-x输入list-packages。搜索sourcetrail用i标记按x安装确认时输入 yes。两条路径装的都是同一个sourcetrail插件按你环境里已有哪条通道选择即可不需要同时执行两条。从 Emacs 发送光标位置插件安装完成后核心操作就是发送光标位置确认 Sourcetrail 已启动并且目标项目已加载、索引已完成。在 Emacs 中把光标停到你想要查看的那个符号或代码位置上。按M-x输入sourcetrail-send-location。插件随后会向 Sourcetrail 的6667端口发出前面说明的setActiveTokenfilelinecolumnEOM消息。如何验证文档对发送侧的成功判定描述为you can select a location within a source file and Sourcetrail will show you all symbols found at this location。也就是说执行sourcetrail-send-location后Sourcetrail 会把该位置处的符号作为当前选中符号展示出来Graph View 中该符号处于激活状态并显示它的出入依赖Code View 列出该符号的全部源码位置。如果你发送了一个索引里不存在的文件位置而 Sourcetrail 没有任何响应说明消息没有送达或位置不在索引范围内——此时先核对下一节的端口与日志。可选分支让 Sourcetrail 反过来定位 Emacs 光标除了Emacs → Sourcetrail方向Sourcetrail 还支持From Sourcetrail在 Sourcetrail 的 Code View 中右键选择Set IDE Cursor或者按住CtrlmacOS 为Cmd点击 Code View 中的某一行就会让编辑器打开对应文件并跳到该位置。要让 Emacs 接住这条moveCursor消息必须先激活sourcetrail-modeM-x sourcetrail-mode文档明确说明To get Location from Sourcetrail the sourcetrail-mode need to be active.。激活后在 Sourcetrail 的 Code View 里用上述两种方式触发Emacs 光标应跳到对应文件的行列位置。如果你只想完成标题所述的发送光标位置这一节可以跳过。排查与限制文档中与本场景直接相关的排查线索只有一条端口。如果sourcetrail-send-location执行后 Sourcetrail 无反应先打开 Sourcetrail 的 Preferences Window核对Sourcetrail Port与Plugin Port两个设置项——插件发来的消息进入6667Sourcetrail 监听端口Sourcetrail 发出的消息去向6666两端必须一致。这两个端口被修改过是文档明确指出的可变项。此外文档在 Preferences 的Logging项下建议If you encounter problems while running Sourcetrail, we recommend to enable this option so you have somewhere to start looking for a cause.即打开日志后可以从日志入手查找原因。日志文件保存在 data 目录的logs子目录Help 菜单的Show Log Folder可直接打开该目录。需要明确的边界文档没有给出 Emacs 插件独立的端口配置项端口以 Sourcetrail Preferences Window 中的设置为准文档没有为 Emacs 插件单独给出默认端口值之外的额外配置如主机地址说明插件侧按 Sourcetrail 插件协议默认的本地 TCP 连接工作Emacs 侧文档只提供了手动package-install-file与 Melpa 两条安装路径没有提供 Elpa 等其他仓库的安装方式。完成标志Emacs 中M-x package-install-file或 Melpa 安装sourcetrail成功光标停在某符号上M-x sourcetrail-send-location后Sourcetrail 的 Graph View / Code View 显示该位置的符号及其依赖与源码位置——发送方向接通可选M-x sourcetrail-mode激活后在 Sourcetrail Code View 中右键Set IDE Cursor或Ctrl/Cmd点击行Emacs 光标跳到对应位置——接收方向接通。两个方向都验证通过后Emacs 与 Sourcetrail 之间的双向联动即按文档描述完成接入。【免费下载链接】SourcetrailSourcetrail - free and open-source interactive source explorer项目地址: https://gitcode.com/GitHub_Trending/so/Sourcetrail创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考