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）时避免不必要的結果

"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
},