GUI 和 IDE 設定

可以使用 Chromium Code Search 線上瀏覽 V8 原始碼。

可以使用許多其他用戶端程式和外掛程式存取這個專案的 Git 存放庫。請參閱用戶端的說明文件以取得更多資訊。

Visual Studio Code 和 clangd #

如需如何為 V8 設定 VSCode 的說明，請參閱這份 文件。目前 (2021) 建議使用此設定。

Eclipse #

如需如何為 V8 設定 Eclipse 的說明，請參閱這份 文件。注意：截至 2020 年，使用 Eclipse 編制 V8 索引無法順利運作。

Visual Studio Code 和 cquery #

VSCode 和 cquery 提供良好的程式碼導覽功能。它提供 C++ 符號的「跳至定義」以及「尋找所有參照」，而且運作良好。本節說明如何在 *nix 系統上取得基本設定。

安裝 VSCode #

使用您偏好的方式安裝 VSCode。本指南的其餘部分假設您可以透過命令 code 從命令列執行 VSCode。

安裝 cquery #

從 cquery 將 cquery 克隆到您選擇的目錄中。我們在本指南中使用 CQUERY_DIR="$HOME/cquery"。

git clone https://github.com/cquery-project/cquery "$CQUERY_DIR"
cd "$CQUERY_DIR"
git submodule update --init
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=release -DCMAKE_INSTALL_PREFIX=release -DCMAKE_EXPORT_COMPILE_COMMANDS=YES
make install -j8

如果發生任何問題，請務必查看 cquery 的入門指南。

您可以使用 git pull && git submodule update 在稍後更新 cquery（別忘了透過 cmake .. -DCMAKE_BUILD_TYPE=release -DCMAKE_INSTALL_PREFIX=release -DCMAKE_EXPORT_COMPILE_COMMANDS=YES && make install -j8 重新建置）。

安裝和設定 VSCode 的 cquery 外掛程式 #

從 VSCode 的市集中安裝 cquery 外掛程式。在您的 V8 簽出中開啟 VSCode

cd v8
code .

在 VSCode 中前往設定，例如，透過捷徑 Ctrl + ,。

將下列內容新增到您的工作區設定，適當地取代 YOURUSERNAME 和 YOURV8CHECKOUTDIR。

"settings": {
  "cquery.launch.command": "/home/YOURUSERNAME/cquery/build/release/bin/cquery",
  "cquery.cacheDirectory": "/home/YOURUSERNAME/YOURV8CHECKOUTDIR/.vscode/cquery_cached_index/",
  "cquery.completion.include.blacklist": [".*/.vscache/.*", "/tmp.*", "build/.*"],
  […]
}

提供 compile_commands.json 給 cquery #

最後一個步驟是為 cquery 產生一個 compile_commands.json。這個檔案將包含用於建置 V8 至 cquery 的特定編譯器命令列。在 V8 簽出中執行下列命令

ninja -C out.gn/x64.release -t compdb cxx cc > compile_commands.json

這需要時不時重新執行，以教導 cquery 有關新原始檔的事項。特別是，你應在變更 BUILD.gn 後，隨時重新執行指令。

其他有用的設定 #

Visual Studio Code 中的括號自動關閉功能無法正常運作。可以使用下列方式停用此功能：

"editor.autoClosingBrackets": false

在使用者設定中。

以下排除遮罩有助於在使用搜尋 (Ctrl+Shift+F) 時避免不必要的結果

"files.exclude": {
  "**/.vscode": true,  // this is a default value
},
"search.exclude": {
  "**/out*": true,     // this is a default value
  "**/build*": true    // this is a default value
},