GUI と IDE の設定

V8 ソースコードは Chromium コード検索 でオンラインで参照できます。

このプロジェクトの 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/.*"],
  […]
}

cquery に compile_commands.json を提供する #

最後の手順は、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) を使用するときに不要な結果を避けるのに役立ちます。検索 (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
},