从零开始：在 Windows 环境下拉取并编译 Chrome 源码全纪录

原创于 2025-12-06 22:07:03 发布 · 1.1k 阅读

20 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

收录于

chrome

c++

架构

编译 Chromium（Chrome 浏览器）源码是一个复杂但非常有趣的过程。你可以从头开始构建自己的浏览器，并对其进行定制，调试或优化。下面是 Windows 平台下，如何获取 Chromium 的源码并进行编译构建的详细步骤。

一、系统要求

在开始之前，确保你的计算机满足以下系统要求：

操作系统：Windows 10 或更高版本。
硬件要求：
- 至少 8GB 内存，推荐 16GB 或更多。
- 至少 100GB 可用硬盘空间（NTFS 格式，FAT32 格式不可用）。
- 64 位处理器。
必需工具：
- Visual Studio 2022（版本 >= 17.0.0）用于编译，并且需要安装 Desktop development with C++ 组件。
- Windows 11 SDK（版本 10.0.26100.4654）及其调试工具。

二、设置 Visual Studio

安装 Visual Studio 2022：
- 下载并安装 Visual Studio 2022，确保选择了 Desktop development with C++ 组件和 MFC/ATL support。
- 你可以通过命令行安装 Visual Studio：
  
  $ PATH_TO_INSTALLER.EXE ^ --add Microsoft.VisualStudio.Workload.NativeDesktop ^ --add Microsoft.VisualStudio.Component.VC.ATLMFC ^ --includeRecommended
Windows SDK 和调试工具：
- 安装 Windows 11 SDK，版本号为 10.0.26100.4654。
- 如果使用 ARM64 进行编译，还需要手动安装调试工具。
安装调试工具：
- 如果 SDK 中没有包含调试工具，可以去 Control Panel > Programs and Features > Windows Software Development Kit 安装调试工具。

三、安装 Git 和 Depot Tools

安装 Git：
- 下载并安装 Git for Windows。
更新 Git：
- 更新现有的 Git 安装，通过以下命令：
  
  git update-git-for-windows
命令行设置临时代理

set http_proxy=http://10.16.13.18:8080

set https_proxy=http://10.16.13.18:8080

netsh winhttp set proxy 10.16.13.18:8080
```
当前的 WinHTTP 代理服务器设置:

    代理服务器: 10.16.13.18:8080

    绕过列表 : (无)
```

安装 Depot Tools：

depot_tools 是 Chromium 构建系统的核心工具。克隆 depot_tools 仓库到指定目录，例如：

$ git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git C:\src\depot_tools

可能的报错

报错一

git clone ssh://git@chromium.googlesource.com/chromium/tools/depot_tools.git
Cloning into 'depot_tools'...
ssh: connect to host chromium.googlesource.com port 22: Network is unreachable
fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.

原因是 SSH 协议默认走 22 端口，而你现在在公司网络或通过 HTTP 代理访问，端口 22 被阻断。即使你设置了 http_proxy/https_proxy 和 WinHTTP 代理，SSH 不会走 HTTP 代理，所以无法连接。


解决方法
方案 1：用 HTTPS 克隆 depot_tools（推荐）
git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
- HTTPS 可以通过你已经设置的 HTTP 代理访问。
- 如果公司网络限制了 HTTPS，需要确保代理能访问外网。

方案 2：SSH + 代理（复杂，不建议）
- 需要配置 ProxyCommand 或 corkscrew 让 SSH 走 HTTP 代理。
- 在 Windows 下比较麻烦，一般只在必须用 SSH 权限操作私有仓库时用。



报错二

git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
Cloning into 'depot_tools'...
fatal: unable to access 'https://chromium.googlesource.com/chromium/tools/depot_tools.git/': schannel: next InitializeSecurityContext failed: Unknown error (0x80092013)

报错2需要执行即可
git config --global http.sslBackend "openssl"

完成后配置环境变量
D:\work\code\SE_AI_Chrome_143\depot_tools 加到path里面，重新启动cmd

~~垃圾玩意删不掉~~

配置环境变量：
- 将 depot_tools 添加到系统的 PATH 环境变量中（确保它在 Python 之前）重启cmd。
- 在环境变量中添加：
  
  DEPOT_TOOLS_WIN_TOOLCHAIN=0
- where gclient看下是不是第一个，下图就没问题
运行 gclient：
- 安装所有 Windows 特定的依赖：
  
  $ gclient

四、获取 Chromium 源码

配置 Git：
配置 Git 用户名和电子邮件：

$ git config --global user.name "My Name" 
$ git config --global user.email "my-name@chromium.org" 
$ git config --global core.autocrlf false 
$ git config --global core.filemode false

创建 Chromium 目录并获取源码：
创建一个新的目录并切换到该目录：

$ mkdir chromium && cd chromium

使用 fetch 命令下载 Chromium 的代码及其依赖：

$ fetch chromium

如果你不需要完整的历史记录，可以加上 --no-history 参数来加速下载：

$ fetch chromium --no-history
可能的报错
同步子仓库：
如果获取过程中出现错误，可以运行以下命令来同步所有子仓库：

$ gclient sync

五、设置构建目录

生成构建文件：
使用 GN（Google’s build system）来生成 Ninja 构建文件。首先，在 src 目录下创建构建目录：

$ cd src $ gn gen out\Default

这将生成用于构建 Chromium 的 out/Default 目录。
可能的问题
构建 Chromium：
使用 autoninja 来执行构建：

$ autoninja -C out\Default chrome

autoninja 是 ninja 的一个包装工具，自动提供最优的参数设置。

六、加速构建

硬件优化：
- 将构建目录存放在 SSD 硬盘上，以提高读写速度。
- 使用多核 CPU（20 核以上）和大量内存（64 GB 以上）可以显著提高构建速度。
配置 gn 参数以优化构建时间：

gn args out\Default --args="is_component_build=true is_debug=true"
禁用防病毒软件和文件系统索引：
- 确保防病毒软件不会扫描构建目录，尤其是在使用 Windows Defender 时。