代码导航

在 MarkNode 中阅读代码时,你可以从函数调用、类型名称或任何其他引用直接跳转到它的定义位置——无论定义在同一文件还是其他文件中——而无需打开单独的 IDE。MarkNode 还会记住你去过的位置,方便你原路返回。

跳转到定义

按住修饰键(macOS 上为 Cmd,Windows 和 Linux 上为 Ctrl),并将鼠标悬停在代码文件中的某个名称上。如果 MarkNode 确切知道该名称的定义位置,该名称会显示下划线,光标也会变为指针。在按住修饰键的同时点击,编辑器就会直接带你过去:如果定义位于其他文件,会先打开该文件,然后将光标放在定义处。

如果名称定义在同一文件中,跳转只会移动光标,不会打开新标签页。如果它定义在项目中的其他位置,MarkNode 会为你打开相应的文件。

支持的语言

代码导航适用于:

  • Rust
  • JavaScript(包括 JSX)
  • TypeScript(包括 TSX)
  • Python
  • Go
  • Java
  • C
  • C++

配置和数据格式(HTML、CSS、JSON、YAML、TOML 和 XML)没有真正意义上的“定义”概念,因此代码导航不适用于它们。你仍然可以正常打开和编辑这些文件,只是按住修饰键悬停时不会显示下划线。

MarkNode 不提供跳转的情况

以下几种情况不会显示下划线:

  • 可能有多种含义的名称——例如,名为 save 的方法存在于多个互不相关的类型上。MarkNode 无法可靠地判断你指的是哪一个,因此与其猜测而冒着跳错位置的风险,不如完全不提供跳转。
  • 局部变量——MarkNode 自身的分析是通过在整个项目中匹配名称来工作的,而不是跟踪每个变量的局部作用域,因此通常不会提供跳转到局部变量的功能。
  • 来自依赖项的名称——如果名称来自你安装的包或库,而不是你项目中的代码,由于 MarkNode 不会查看依赖项内部,因此无法解析它。
  • 注释、字符串和标点符号——这些本来就不是用来跳转的目标。

在上述所有情况下,按住修饰键点击只会将光标放在你点击的位置,与普通点击完全相同。

后退与前进

每次跳转都会被记录下来,因此你可以像使用网页浏览器的后退和前进按钮一样原路返回:

  • 后退:macOS 上为 Cmd+[,Windows 和 Linux 上为 Ctrl+Alt+Left
  • 前进:macOS 上为 Cmd+],Windows 和 Linux 上为 Ctrl+Alt+Right

这两项操作也可以从菜单栏的 Go 菜单中使用。后退会让你精确回到跳转前光标所在的位置;如果你之后已切换到其他文件,会先重新打开原文件。前进仅在刚刚执行后退之后可用——跳转到新位置会清除前进历史,这与浏览器的行为相同。

借助语言服务器获得更准确的结果

MarkNode 自身的代码导航完全离线工作,无需任何设置——打开项目后即可使用。如果你还为某种语言安装了语言服务器,MarkNode 会自动找到并使用它来提升结果的准确性,例如根据调用对象的类型来解析方法调用,而这是 MarkNode 自身的分析未必总能独立做到的。

MarkNode 会查找哪些程序

语言MarkNode 查找的程序
Rustrust-analyzer
JavaScript 和 TypeScripttypescript-language-server
Pythonpyright-langserver,其次是 pylsp
Gogopls
C 和 C++clangd
Java无

对于 Python,如果安装了 Pyright,MarkNode 会使用它,否则使用 Python LSP Server。

Java 没有受支持的语言服务器,因此无论你安装了什么,Java 文件始终使用 MarkNode 自身的分析。

安装语言服务器

语言服务器需要你在 MarkNode 之外自行安装,方式与为其他编辑器安装相同。在终端中运行对应语言的命令:

  • Rust:rustup component add rust-analyzer
  • JavaScript 和 TypeScript:npm install -g typescript-language-server typescript@6。该语言服务器需要 TypeScript 6 或更早版本:TypeScript 7 不再包含它所运行的组件,因此使用 TypeScript 7 时语言服务器无法启动。
  • Python:npm install -g pyright,或 pipx install python-lsp-server
  • Go:go install golang.org/x/tools/gopls@latest
  • C 和 C++:
    • macOS:clangd 随 Xcode Command Line Tools 一起提供(xcode-select --install)。你也可以运行 brew install llvm——Homebrew 不会将 LLVM 添加到你的 PATH,但 MarkNode 仍然能找到其中的 clangd。
    • Linux:安装你所用发行版的 clangd 软件包,例如 sudo apt install clangd。
    • Windows:运行 llvm.org 提供的 LLVM 安装程序,并让它将 LLVM 添加到你的 PATH。

查看 MarkNode 找到了什么

打开设置,进入编辑器页面,查看代码导航部分。其中列出了每种受支持的语言,以及代码导航当前为其使用的方式:

  • MarkNode 自身的分析——未找到语言服务器。该行会列出 MarkNode 查找的程序名称,方便你知道需要安装什么。
  • 已找到——语言服务器已安装,该行会显示其所在位置。
  • 运行中——MarkNode 正在使用该语言服务器。语言服务器只会在你首次在当前打开的项目中对该语言使用转到定义时启动,在此之前该行显示已找到。
  • 已找到,但启动失败——程序存在,但未能启动。对于 Rust,这通常表示已安装 rustup,但未安装其 rust-analyzer 组件;请运行 rustup component add rust-analyzer,然后点击重新检查。
  • 多次失败后已停止——语言服务器持续失败,因此 MarkNode 将其停止,并改回使用自身的分析。

未打开项目时,该部分只显示 MarkNode 能否找到每个语言服务器。

你也可以在终端中独立于 MarkNode 进行检查。在 macOS 或 Linux 上运行 which gopls,在 Windows 上运行 where gopls,并将程序名替换为你所用语言对应的程序。如果输出了路径,说明该程序已安装,且你的终端能够找到它。

重新检查

安装语言服务器后,立即点击“代码导航”部分中的重新检查。MarkNode 会重新查找语言服务器,无需重启。已在运行的语言服务器会继续运行,而启动失败或多次失败后已停止的语言服务器会重新尝试启动。