Chromium 134 编译指南 Windows篇：环境变量配置（三）

引言

在之前的 Chromium 编译指南系列文章中，我们已经完成了编译前的准备工作以及 depot_tools 工具的安装与配置。本篇我们将聚焦于 Chromium 编译过程中至关重要的环境变量设置，这些配置是您顺利进行 Chromium 构建的基石。正确配置环境变量不仅能帮助您避免编译过程中的各种错误，还能使整个构建过程更加高效。

1 理解环境变量的重要性

1.1 环境变量在编译过程中的作用

环境变量是操作系统中的一种全局设置，可以影响程序的运行行为。在 Chromium 编译过程中，环境变量主要用于：

• 指定工具链和编译器的位置
• 控制编译过程的行为和参数
• 设置资源路径和依赖项位置
• 启用或禁用特定功能和优化

1.2 为什么需要自定义环境变量

Chromium 的构建系统默认会使用 Google 内部的工具链和配置，这对于大多数开发者来说既不必要也不可行。通过设置特定的环境变量，我们可以：

• 使用本地安装的开发工具而非 Google 内部版本
• 适应不同的开发环境和硬件条件
• 优化构建过程以提高效率
• 解决特定平台上的构建问题

2 启用本地编译：配置 DEPOT_TOOLS_WIN_TOOLCHAIN 环境变量

为了确保我们使用本地的计算资源来编译 Chromium，需要设置 DEPOT_TOOLS_WIN_TOOLCHAIN 环境变量。该设置将指示 depot_tools 使用您本地安装的 Visual Studio 进行编译，而非默认的 Google 内部版本。

2.1 设置步骤

1. 打开系统环境变量设置窗口（具体步骤请参考之前的教程）
2. 在"系统变量"区域，点击"新建"按钮
3. 在新建变量对话框中：
   • 变量名：输入 DEPOT_TOOLS_WIN_TOOLCHAIN
   • 变量值：输入 0
4. 点击"确定"保存此新变量

2.2 验证设置

请确保在系统变量列表中可以看到新添加的 DEPOT_TOOLS_WIN_TOOLCHAIN 变量，且其值为 0。这个值告诉构建系统使用本地安装的 Visual Studio，而不是尝试下载 Google 的内部工具链。

注意：如果您之前已经设置过这个变量（在安装 depot_tools 时），则无需重复设置。您可以通过检查当前环境变量列表来确认。

3 设置 Visual Studio 2022 安装路径

为了让编译系统能够正确找到您的 Visual Studio 安装位置，我们需要设置一个环境变量，指向 Visual Studio 2022 的安装路径。

3.1 确定 Visual Studio 安装路径

首先，您需要确认 Visual Studio 2022 的确切安装位置。通常，Visual Studio 2022 的默认安装路径为：

• 社区版：C:\Program Files\Microsoft Visual Studio\2022\Community
• 专业版：C:\Program Files\Microsoft Visual Studio\2022\Professional
• 企业版：C:\Program Files\Microsoft Visual Studio\2022\Enterprise

您可以通过以下方法确认实际安装路径：

1. 打开 Visual Studio Installer
2. 查看已安装的 Visual Studio 2022 版本的安装位置

3.2 设置 vs2022_install 环境变量

1. 在"系统变量"区域，点击"新建"按钮
2. 在新建变量对话框中：
   • 变量名：输入 vs2022_install
   • 变量值：您可以通过以下两种方式设置这个值：
     • a. 直接输入路径，例如：C:\Program Files\Microsoft Visual Studio\2022\Community
     • b. 或者，点击"浏览目录"，导航到您的 Visual Studio 2022 安装文件夹并选择它
3. 点击"确定"保存此新变量

3.3 验证设置

请确保在系统变量列表中可以看到新添加的 vs2022_install 变量，且其值正确指向您的 Visual Studio 2022 安装目录。

4 配置其他可选的环境变量

除了上述两个必要的环境变量外，您还可以设置一些可选的环境变量来优化构建过程或解决特定问题：

4.1 设置临时目录

Chromium 编译过程会生成大量临时文件，默认情况下这些文件会保存在系统的临时目录中。如果您的系统盘空间有限，可以考虑将临时目录设置到其他分区：

1. 创建两个新的系统变量：
   • 变量名：TEMP，变量值：D:\Temp（替换为您希望使用的路径）
   • 变量名：TMP，变量值：与 TEMP 相同
2. 确保目标目录已存在并且用户对其有写入权限

5 注意事项与常见问题

在配置环境变量时，以下几点需要特别注意：

5.1 路径与编码问题

• 为避免潜在的编码问题，路径中请避免使用非 ASCII 字符
• 路径中最好不要包含空格，虽然 Windows 支持带空格的路径，但某些脚本可能会出现问题
• 确保所有路径都使用反斜杠 (\)，而不是正斜杠 (/)

5.2 权限问题

• 设置系统环境变量通常需要管理员权限
• 确保用于编译的用户账户对所有相关目录有足够的访问权限

5.3 生效问题

• 设置环境变量后，可能需要重启命令提示符、PowerShell 或整个系统才能使变量生效
• 如果在 IDE 中工作，可能需要重启 IDE 以加载新的环境变量

5.4 验证环境变量

您可以通过以下方法验证环境变量是否正确设置：

1. 打开命令提示符或 PowerShell
2. 输入以下命令查看特定环境变量：

echo %DEPOT_TOOLS_WIN_TOOLCHAIN%
echo %vs2022_install%

1. 或者使用以下命令查看所有环境变量：

set

6 结语

通过以上步骤，我们成功配置了 Chromium 编译过程中的两个关键环境变量：

1. DEPOT_TOOLS_WIN_TOOLCHAIN：确保使用本地的 Visual Studio 进行编译
2. vs2022_install：指定 Visual Studio 2022 的安装路径

这些设置为接下来的 Chromium 编译工作奠定了坚实的基础。正确配置环境变量不仅能确保编译过程的顺利进行，还能帮助您在遇到问题时更快地定位和解决问题。

在下一篇文章《Chromium 134 编译指南 Windows篇：Git 配置（四）》中，我们将深入探讨如何配置 Git 版本控制系统，它是管理 Chromium 庞大代码库的必备工具。我们将介绍 Git 的安装、基本配置，以及如何使用 Git 与 Chromium 项目进行高效的版本控制和协作。掌握这些技能将帮助您更好地参与到 Chromium 的开发中，跟踪代码变更，并与全球的开发者社区紧密协作。敬请期待！