Windows平台Chromium 145编译环境搭建与优化指南

1. Chromium 145 Windows编译环境全景搭建

在Windows平台编译Chromium 145源码是个系统工程，需要精确配置工具链和环境参数。作为长期维护Chromium衍生浏览器的开发者，我总结出这套经过实战验证的环境准备方案，相比官方文档更注重实操中的细节处理。

编译环境的核心是工具链版本匹配。Chromium 145要求：

• Windows 10/11 21H2及以上版本（实测22H2最稳定）
• Visual Studio 2022（必须包含17.4.33110.0以上版本的MSVC工具集）
• Windows 10 SDK 10.0.22621.0（注意不是最新版）
• Windows Driver Kit 10.0.22621.0（WDK）

关键提示：切勿使用VS2022的默认安装选项，必须通过Visual Studio Installer单独勾选"使用C++的桌面开发"工作负载，并额外添加以下组件：

• Windows 11 SDK (10.0.22621.0)
• C++ ATL for latest v143 build tools
• C++ MFC for latest v143 build tools
• Windows 10 SDK (10.0.19041.0) 兼容组件

2. 磁盘与系统配置优化

Chromium源码编译需要消耗大量磁盘IO和内存资源，建议采用以下优化方案：

2.1 存储方案选择

• 固态硬盘：至少500GB NVMe SSD（编译目录需要200GB+空间）
• 分区格式：NTFS（不可用exFAT/FAT32）
• 分配单元大小：64KB（格式化时指定）

实测数据：在三星980 Pro 1TB上，将分配单元从默认4KB改为64KB后，编译速度提升18%。

2.2 系统参数调整

# 以管理员身份执行 powercfg /setactive SCHEME_MIN reg add "HKLM\SYSTEM\CurrentControlSet\Control\FileSystem" /v NtfsDisableLastAccessUpdate /t REG_DWORD /d 1 /f reg add "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management" /v IoPageLockLimit /t REG_DWORD /d 4194304 /f

2.3 虚拟内存配置

即使物理内存充足（如32GB），仍需设置16GB以上的分页文件：

• 初始大小：16384 MB
• 最大值：32768 MB 存储在SSD的第二分区（非系统盘）

3. 依赖工具链精准安装

3.1 depot_tools配置

:: 在PowerShell中执行 $env:Path = "C:\depot_tools;" + $env:Path [Environment]::SetEnvironmentVariable("Path", $env:Path, "Machine") git config --global core.autocrlf false git config --global core.filemode false git config --global branch.autosetuprebase always

3.2 必须的第三方工具

1. Python 3.11.x（不可用3.12+）
   • 安装时勾选"Add python.exe to PATH"
   • 执行python -m pip install -U pip setuptools wheel
2. Git 2.42.0.windows.2（必须此特定版本）
3. 7-Zip 22.01（添加bin目录到PATH）

3.3 环境变量关键配置

DEPOT_TOOLS_WIN_TOOLCHAIN=0 GYP_MSVS_VERSION=2022 GYP_MSVS_OVERRIDE_PATH=C:\Program Files\Microsoft Visual Studio\2022\Community WINDOWSSDKDIR=C:\Program Files (x86)\Windows Kits\10

4. 源码获取与同步技巧

4.1 代码下载优化

fetch --no-history chromium cd src git config --global core.preloadindex true git config --global core.fscache true git config --global gc.auto 256

4.2 gclient同步加速

创建.gclient文件添加：

solutions = [ { "managed": False, "name": "src", "url": "https://chromium.googlesource.com/chromium/src.git", "custom_deps": {}, "deps_file": ".DEPS.git", "safesync_url": "", "cache_dir": "D:\\chromium_git_cache" # 指定到SSD二级目录 } ] cache_dir = "D:\\chromium_git_cache"

执行同步命令：

gclient sync --with_branch_heads --with_tags -v -D --no-history

常见问题：若遇到"Could not resolve host"错误，修改DNS为8.8.8.8或1.1.1.1后重试

5. 编译前最终检查清单

1. 版本验证：

   clang-cl --version # 应显示17.0.0以上 ninja --version # 需1.11.1+

2. 生成编译配置：

   gn gen out/Default --args="is_debug=false enable_nacl=false symbol_level=1 blink_symbol_level=1"

3. 内存泄漏检测（可选）： 在args中添加：

   use_asan = true use_lsan = true

4. 编译启动：

   autoninja -C out/Default chrome

   建议配合：

   start /B /WAIT /HIGH autoninja -C out/Default chrome

6. 性能调优实战参数

在SSD+32GB内存环境下，这些参数可缩短30%编译时间：

# args.gn关键优化 target_cpu = "x64" is_component_build = false enable_precompiled_headers = true use_thin_lto = true thin_lto_enable_optimizations = true

对于多核CPU（如i9-13900K）：

set DEPOT_TOOLS_WIN_TOOLCHAIN=0 set NINJA_SUMMARIZE_BUILD=1 set NINJA_STATUS="[%f/%t] %es " autoninja -C out/Default chrome -j 32

编译过程中若出现OOM，可尝试：

set GYP_MSVS_OVERRIDE_PATH="C:\Program Files\Microsoft Visual Studio\2022\Community" set CL=/MP /Zm500