引言

经过前三篇的准备，你已经拥有了编译 Chromium 所需的所有工具：Visual Studio 和 Windows SDK、正确配置的 Git、即将使用的 depot_tools。但这些工具就像分散的乐高积木——需要通过系统环境变量这条"红线"串联起来，才能形成一个完整的、协调工作的系统。

环境变量是 Windows 操作系统的语言，它告诉系统工具在哪里、以什么优先级使用它们。不正确的环境变量配置会导致编译系统找不到所需的工具、使用错误版本的编译器、或陷入优先级混乱。本篇将指导你完成编译 Chromium 142 所需的所有关键环境变量设置。这是最后的环境准备步骤，完成后你就真正做好了编译的准备。

1 理解环境变量的作用

1.1 什么是环境变量

环境变量是操作系统为应用程序提供的一组配置参数。它们存储在系统内存中，当你打开命令行窗口时，这些变量就立即可用。

对于 Chromium 编译来说，环境变量的作用包括：

• 路径指示：告诉编译系统 Visual Studio、Windows SDK 等工具安装在哪里

• 优先级管理：当系统中有多个版本的同一工具时（如多个 Python 版本），环境变量决定使用哪一个

• 行为控制：某些工具的行为由特定的环境变量控制（如 depot_tools 的自动更新行为）

• 编译优化：某些高级配置通过环境变量实现

1.2 为什么 Chromium 编译需要特别配置

Chromium 编译系统（GN + Ninja）对环境的要求非常严格。一个环境变量配置错误，可能导致：

• 编译器找不到必要的头文件

• 链接器找不到库文件

• Python 脚本使用了错误版本

• depot_tools 与系统中的其他工具产生冲突

因此，准确的环境变量配置是编译成功的基石。

2 关键环境变量配置

2.1 必需变量：DEPOT_TOOLS_WIN_TOOLCHAIN

这是最关键的一个配置。默认情况下，depot_tools 会尝试使用 Google 内部的编译工具链，这对普通开发者不可用。设置这个变量告诉系统使用你本地安装的 Visual Studio。

变量名：DEPOT_TOOLS_WIN_TOOLCHAIN

变量值：0

设置方式：

1. 打开系统环境变量编辑器
2. 在"系统变量"区域点击"新建"
3. 变量名输入 DEPOT_TOOLS_WIN_TOOLCHAIN
4. 变量值输入 0
5. 点击"确定"

✅ 验证：打开新的命令提示符，输入 echo %DEPOT_TOOLS_WIN_TOOLCHAIN% 应该显示 0

⚠️ 重要：如果这个变量设置错误或缺失，编译会尝试下载 Google 的内部工具链，这会导致失败或非常缓慢。

2.2 必需变量：Visual Studio 安装路径

编译系统需要知道你的 Visual Studio 2022 安装在哪里。

确定你的 VS 安装路径：

典型路径为：

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

如何确认：

1. 打开 Visual Studio Installer（在开始菜单中搜索）
2. 找到已安装的 Visual Studio 2022
3. 点击"更多"菜单 → "在文件资源管理器中显示"
4. 记录显示的路径

设置变量：

变量名：vs2022_install

变量值：你的 Visual Studio 安装路径

例如：

vs2022_install=C:\Program Files\Microsoft Visual Studio\2022\Community

设置步骤同上（新建系统变量）。

✅ 验证：echo %vs2022_install% 应该显示你的 VS 安装路径

2.3 可选变量：Windows SDK 路径

通常这个路径在安装 SDK 时已自动设置，但如果遇到编译错误，手动设置可以解决：

变量名：WINDOWSSDKDIR

变量值：C:\Program Files (x86)\Windows Kits\11

(如果安装的是 Windows 10 SDK，路径调整为 Windows Kits\10)

✅ 验证：echo %WINDOWSSDKDIR% 应该显示 SDK 路径

2.4 可选变量：自定义临时目录

编译过程会生成大量临时文件（可能几十GB）。如果你的系统盘空间有限，可以指定其他分区：

变量名 1：TEMP

变量值：D:\Temp

变量名 2：TMP

变量值：D:\Temp（与 TEMP 相同）

⚠️ 确保目标目录已存在，且你的用户账户对其有读写权限。

2.5 禁用 Python 别名（Windows 11 特定）

Windows 11 内置了 Python 别名，会与 depot_tools 的 Python 冲突。

方法 1：通过 GUI 禁用（推荐）

1. 打开"设置" → "应用" → "应用执行别名"
2. 找到 "python.exe" 和 "python3.exe"
3. 关闭它们的切换开关

方法 2：通过环境变量禁用

添加环境变量：

PYTHONPATH=（留空）

3.1 打开环境变量编辑器

有多种方式打开"编辑环境变量"对话框：

方法 1：通过系统属性（推荐）

1. 右键"此电脑"或"我的电脑"
2. 选择"属性"
3. 点击"高级系统设置"
4. 点击"环境变量"按钮

方法 2：通过设置应用

1. Win + I 打开设置
2. 搜索"环境"
3. 点击"编辑系统环境变量"

方法 3：通过 PowerShell（脚本自动化）

# 以管理员身份运行
[Environment]::SetEnvironmentVariable("vs2022_install", "C:\Program Files\Microsoft Visual Studio\2022\Community", "Machine")

3.2 添加/修改系统变量

在"系统变量"区域（不是"用户变量"）：

1. 点击"新建"按钮
2. 输入变量名（如 vs2022_install）
3. 输入变量值（如 C:\Program Files\Microsoft Visual Studio\2022\Community）
4. 点击"确定"

对于 Path 变量的编辑（因为它已经存在）：

1. 选中"Path"变量
2. 点击"编辑"
3. 在新窗口中，看到所有已有的路径
4. 点击"新建"添加 depot_tools 的路径
5. 使用"上移"按钮将其移到最前面
6. 点击"确定"保存

3.3 应用更改

⚠️ 重要：环境变量更改需要重启才能在新的命令行窗口中生效！

1. 关闭所有打开的命令提示符和 PowerShell 窗口
2. 重启计算机（或注销再登录）
3. 打开新的命令提示符窗口
4. 验证环境变量

4 验证所有环境变量

4.1 检查单个变量

echo %vs2022_install%
echo %WINDOWSSDKDIR%
echo %DEPOT_TOOLS_WIN_TOOLCHAIN%

每个命令应该显示对应的值。如果显示空白或变量名本身，说明设置不成功。

4.2 检查 PATH 中的 depot_tools

echo %PATH%

查看输出，确保 C:\dev\depot_tools（或你的路径）出现在最前面，且路径之间用分号分隔。

4.3 验证工具可用性

git --version
python3 --version
ninja --version
gn --version

这四个命令应该都能输出版本号。如果有任何一个失败，说明 PATH 配置有问题。

5 常见问题排查

Q：修改了环境变量但没有生效

A：需要重新打开命令行窗口。环境变量是在打开窗口时读取的，不会实时刷新。如果仍然无效，需要重启计算机。

Q：PATH 变量太长，添加新路径时提示超过限制

A：这是 Windows 的已知限制。解决方案：

1. 删除一些不必要的 PATH 条目
2. 或者将 depot_tools 路径放在一个软连接中，使用较短的路径

Q：多个版本的工具互相干扰

A：调整 PATH 中各个工具的顺序。优先级从高到低排列希望优先使用的工具。

Q：环境变量被意外重置

A：某些应用程序安装时会修改 PATH。如果出现问题，检查最近安装的软件，考虑卸载或重新安装。

6 高级配置（可选）

6.1 为不同项目使用不同配置

如果你同时维护多个 Chromium 版本，可以使用批处理脚本来切换环境变量：

@echo off
REM 设置 Chromium 142 环境
set vs2022_install=C:\Program Files\Microsoft Visual Studio\2022\Community
set WINDOWSSDKDIR=C:\Program Files (x86)\Windows Kits\11
set DEPOT_TOOLS_WIN_TOOLCHAIN=0
set PATH=C:\dev\depot_tools;%PATH%
cmd

保存为 .bat 文件，双击运行会打开一个新的命令行窗口，该窗口中所有环境变量都已正确配置。

6.2 使用 vswhere 自动检测 Visual Studio

对于想要自动适应不同 VS 版本的高级用户：

for /f "usebackq tokens=*" %A in (`vswhere -latest -property installationPath`) do (
  set vs2022_install=%A
)

这个命令会自动找到系统中最新的 Visual Studio 安装路径。

结语

恭喜！你已经完成了 Chromium 编译环境的全面配置。从硬件检查、编译工具安装、版本控制系统配置，再到系统环境变量的精细调整——每一步都为最终的编译成功奠定了基础。

此刻，你的系统已经进入"临战状态"。所有的工具都已就位，所有的配置都已生效，整个编译环境已经协调一致。剩下的，就是真正的代码下载和编译工作了。

下一篇《Chromium 142 编译指南 Windows篇：获取源代码（五）》将带你使用配置好的 depot_tools 和 git 来克隆和同步 Chromium 的完整源代码库。这是一个激动人心的时刻——30GB 的浏览器引擎源代码即将来到你的硬盘上。做好准备，下一段旅程即将开始！