程式碼導覽

在 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

這兩項也可以從選單列的前往選單中使用。返回會讓你回到跳轉前游標所在的確切位置;如果你之後已切換到其他檔案,會先重新開啟該檔案。前進只有在剛返回後才能使用——跳到新的位置會清除前進記錄,就和瀏覽器一樣。

透過語言伺服器取得更準確的結果

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 會重新尋找語言伺服器,不需要重新啟動。已在執行中的語言伺服器會繼續執行,而無法啟動或在多次失敗後被停止的語言伺服器則會再試一次。