最近在技术社区看到不少关于 Chromium 源码下载、编译和二次开发的讨论，尤其是国内开发者如何高效获取源码、集成 WebRTC 等模块，以及利用 Delphi 等语言结合 Chromium 进行自动化测试的需求日益增长。这背后反映的是 Chromium 作为现代浏览器内核的基石，其庞大的代码库和强大的能力正被越来越多的桌面应用、嵌入式系统和自动化工具所集成。然而，对于大多数开发者而言，从零开始搭建 Chromium 开发环境、理解其构建系统、并成功编译出一个可用的版本，依然是一个充满挑战的“硬骨头”。本文将系统性地拆解 Chromium 源码的获取、环境搭建、基础编译到实际应用（如 WebRTC 模块提取、自动化模拟点击）的全流程，并提供一套经过验证的、可复现的实操方案，旨在帮助中高级开发者跨越入门门槛，将 Chromium 的强大能力整合到自己的项目中。

1. 理解 Chromium：不仅仅是浏览器

在动手之前，我们有必要厘清 Chromium 的核心价值和应用边界。Chromium 是一个由 Google 主导开发的开源浏览器项目，它为 Google Chrome、Microsoft Edge、Opera 等众多知名浏览器提供了内核基础。但其意义远不止于“浏览器内核”。

核心定位 ：Chromium 是一个构建现代 Web 平台的完整解决方案。它包含了 Blink 渲染引擎、V8 JavaScript 引擎、网络栈、GPU 加速、多媒体处理等一整套复杂且高性能的组件。

常见应用场景 ：

  1. 浏览器开发 ：基于 Chromium 定制开发新的浏览器产品。
  2. 嵌入式 Web 视图 ：在桌面应用（如 Electron、CEF）或移动应用中嵌入浏览器控件，用于显示 Web 内容。
  3. 自动化测试与爬虫 ：通过无头模式或驱动协议（如 Chrome DevTools Protocol）控制浏览器进行网页自动化操作、数据抓取或功能测试。
  4. 特定模块复用 ：提取其部分组件，如 WebRTC 用于音视频通信，PDF 渲染引擎用于文档处理，或网络栈用于自定义 HTTP 客户端。
  5. 研究与学习 ：学习大型 C++ 项目的架构、设计模式和性能优化技巧。

与 Chrome 的关键区别 ：Chromium 是开源项目，版本更新更快，但默认不包含 Google 的专有组件（如 Widevine DRM、自动更新、使用情况统计等）。Chrome 则是在 Chromium 基础上，由 Google 集成其服务并发布的产品。对于开发者集成而言，Chromium 是更纯粹和自由的选择。

理解这些，就能明白为什么我们需要直接面对 Chromium 源码：无论是为了深度定制，还是为了提取其精华模块，源码是唯一的入口。

2. 环境准备：构建巨型项目的基石

编译 Chromium 对系统环境有较高要求，官方推荐在 Linux 或 macOS 上进行，Windows 也可行但过程更复杂。以下配置以 Ubuntu 20.04 LTS 或更新版本为例，这是社区验证最顺畅的路径。

2.1 系统与硬件要求

  • 操作系统 ：64位 Ubuntu 20.04+， macOS 10.15+， 或 Windows 10+（需安装 Visual Studio 和 Windows SDK）。
  • 内存 ： 强烈建议 16GB 或以上 。8GB 内存在高并发编译时极易导致系统卡死或编译失败。
  • 硬盘空间 ：至少预留 100GB 的可用空间。源码、依赖和输出目录会占用巨大空间。
  • 网络 ：稳定、高速的网络连接至关重要，因为需要下载数十 GB 的源码和依赖。

2.2 安装基础依赖工具

在 Ubuntu 上，首先安装必要的工具和库。 

# 更新包列表并安装基础工具
sudo apt update
sudo apt install -y git curl wget python3 python3-pip

# 安装 Chromium 构建所需的核心依赖
sudo apt install -y \
    lsb-release \
    software-properties-common \
    gnupg \
    ca-certificates \
    build-essential \
    clang \
    lld \
    ninja-build \
    pkg-config \
    libglib2.0-dev \
    libnss3-dev \
    libatk1.0-dev \
    libatk-bridge2.0-dev \
    libxdamage-dev \
    libxkbcommon-dev \
    libxcomposite-dev \
    libxrandr-dev \
    libgbm-dev \
    libasound2-dev \
    libpulse-dev \
    libdrm-dev \
    libjpeg-dev \
    libpng-dev \
    libwebp-dev

2.3 配置 Depot Tools

Depot Tools 是 Google 为管理 Chromium 等大型开源项目而开发的一套工具集，包含 gclient 、 fetch 等核心命令。 

# 1. 克隆 depot_tools 仓库
git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git ~/depot_tools

# 2. 将其添加到 PATH 环境变量（永久生效，写入 ~/.bashrc 或 ~/.zshrc）
echo 'export PATH="$HOME/depot_tools:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 3. 验证安装
which gclient
# 应输出类似 /home/yourname/depot_tools/gclient 的路径

重要提示 ：避免使用 sudo 运行 depot_tools 中的命令，这可能导致权限问题。

3. 获取 Chromium 源码

这是国内开发者最容易遇到困难的环节。由于仓库托管在境外，直接克隆速度极慢且容易中断。以下是经过验证的可靠方法。

3.1 使用镜像源或代理（推荐）

最根本的解决方案是配置网络代理或使用国内镜像。如果你有可用的网络工具，可以为其配置代理： 

# 设置 git 和 curl 的代理（请替换 your_proxy_host 和 port）
export https_proxy=http://your_proxy_host:port
export http_proxy=http://your_proxy_host:port

# 设置 gclient 的代理，编辑 ~/.boto 文件（如果没有则创建）
cat > ~/.boto << EOF
[Boto]
proxy = your_proxy_host
proxy_port = port
EOF

3.2 执行 Fetch 命令

配置好网络后，使用 fetch 命令获取代码。这个过程会下载超过 30GB 的数据，请耐心等待。 

# 创建一个专门的工作目录并进入
mkdir ~/chromium && cd ~/chromium

# 获取代码。`--no-history` 可以节省时间和空间，只下载最新代码，不包含完整历史记录。
# 如果你想进行深度开发或追溯历史，可以去掉此参数。
fetch --nohooks chromium

fetch 脚本会自动：

  1. 初始化 gclient 配置。
  2. 同步主仓库 ( src )。
  3. 同步所有依赖的子模块（通过 DEPS 文件管理）。

3.3 同步与切换分支

同步完成后，进入 src 目录。你可以选择同步到特定的稳定分支，这通常比 main 分支问题更少。 

cd ~/chromium/src

# 查看所有分支
git fetch origin

# 切换到某个稳定分支，例如 120.0.6099.0 对应的分支
git checkout -b my_branch 120.0.6099.0

# 同步依赖到该分支状态
gclient sync --with_branch_heads --with_tags

4. 配置与编译：生成你的 Chromium

获取源码只是第一步，正确的配置是成功编译的关键。

4.1 运行安装钩子 (Hooks)

首次获取代码后，或切换分支后，需要运行钩子来下载平台特定的二进制文件（如 SDK、工具链）。 

cd ~/chromium/src
gclient runhooks

4.2 生成构建配置

Chromium 使用 GN (Generate Ninja) 作为元构建系统，它比旧的 GYP 更快更灵活。 

# 在 src 目录下，为 out/Default 输出目录生成配置
gn gen out/Default

这会在 out/Default 下生成 args.gn 文件。你可以编辑此文件来定制编译选项。 

# 编辑构建参数
gn args out/Default

这将打开一个编辑器，你可以添加或修改参数。以下是一个适用于开发调试的常用配置： 

# 设置目标操作系统和 CPU
target_os = "linux"
target_cpu = "x64"

# 启用官方构建模式（优化更多，但编译更慢）或调试模式
is_debug = false          # 发布模式，性能好
is_official_build = true # 启用官方级别的优化
# is_debug = true        # 调试模式，带符号，便于调试

# 启用/禁用特定组件
is_component_build = false # 静态链接，生成单个可执行文件，启动快
enable_nacl = false        # 通常不需要 NaCl
blink_enable_generated_code_formatting = false # 加速编译

# 符号级别（即使 is_debug=false，也可保留部分符号用于崩溃分析）
symbol_level = 1

# 编译内容，可以精简以加快编译
dcheck_always_on = false

4.3 开始编译

使用 Ninja 进行实际编译。利用多核 CPU 可以显著加速。 

# 使用所有 CPU 核心进行编译，-j 后面跟核心数，例如 -j16
autoninja -C out/Default chrome
# 或者编译更精简的 “chrome_sandbox” 等目标
# autoninja -C out/Default chrome_sandbox

autoninja 是 depot_tools 提供的脚本，会自动根据你的机器配置设置合适的并行任务数 ( -j )。编译过程视机器性能而定，可能需要数小时。首次编译后，后续增量编译会快很多。

4.4 运行编译产物

编译成功后，你可以在输出目录找到浏览器可执行文件。 

# 运行你刚刚编译的 Chromium
out/Default/chrome

如果一切顺利，一个由你亲手编译的 Chromium 浏览器将会启动。你可以通过 chrome://version 查看详细的版本和编译信息。

5. 实战应用一：提取与使用 WebRTC 源码

很多开发者关注 Chromium 是为了其中的 WebRTC 模块。虽然 WebRTC 有独立的开源项目，但 Chromium 中的版本通常更新更快，且与浏览器深度集成。以下是如何在 Chromium 源码树中定位和初步使用 WebRTC。

5.1 定位 WebRTC 代码

WebRTC 的代码位于 Chromium 源码树的 third_party/webrtc 目录下。 

cd ~/chromium/src/third_party/webrtc
ls -la

你会看到 api , call , media , modules , p2p , rtc_base 等核心目录。这就是完整的 WebRTC 实现。

5.2 编译独立的 WebRTC 目标

你可以在 Chromium 的构建框架内，单独编译 WebRTC 的库或测试工具。 

cd ~/chromium/src
# 编译 WebRTC 的公共库目标
autoninja -C out/Default rtc_base
# 编译一个示例程序，例如 peerconnection_client
autoninja -C out/Default peerconnection_client

编译后的静态库或可执行文件会位于 out/Default 目录下。

5.3 为外部项目构建 WebRTC

若想将 WebRTC 用于非 Chromium 项目（如你的 C++ 音视频应用），更标准的做法是直接获取 WebRTC 原生项目 的源码并编译。虽然这与 Chromium 分离，但构建方式类似： 

# 获取 WebRTC 原生代码（同样需要 depot_tools 和代理）
mkdir ~/webrtc && cd ~/webrtc
fetch webrtc
cd src
# 生成构建文件并编译
gn gen out/Default --args='is_debug=false target_os="linux" target_cpu="x64"'
autoninja -C out/Default

这样会在 out/Default/obj 下生成 libwebrtc.a 等库文件，可供链接。

6. 实战应用二：基于 CEF 或 Delphi 的自动化控制

“Delphi Chromium 模拟点击按钮”这个热词指向一个典型场景：在 Delphi 桌面应用中嵌入浏览器组件并实现自动化。最成熟的方案是使用 CEF 。

6.1 什么是 CEF？

CEF (Chromium Embedded Framework) 是一个将 Chromium 浏览器嵌入其他应用程序的框架。它提供了精简的 API，隐藏了 Chromium 底层的复杂性，支持多种语言绑定（包括 Delphi）。

6.2 Delphi 中使用 CEF4Delphi

CEF4Delphi 是 Delphi 下最活跃的 CEF 封装库。

步骤概览 ：

  1. 获取 CEF 二进制文件 ：从 CEF 官网 下载与你的 Delphi 项目平台（Windows 32/64位）匹配的“标准发行版”。解压后得到包含 libcef.dll 、 chrome_elf.dll 及 Resources 子目录的包。
  2. 安装 CEF4Delphi 组件包 ：在 Delphi 中打开 CEF4Delphi 源码中的 packages 目录下的 dpk 文件，编译并安装。
  3. 创建浏览器窗口 ：在窗体上放置 TChromium 和 TCEFWindowParent 组件，并建立关联。
  4. 加载网页与模拟交互 ：通过 TChromium 的方法加载网页，并使用 ExecuteJavaScript 执行 JS 代码，或通过 SendMouseClickEvent 等方法模拟鼠标点击。

关键代码示例（模拟点击） ： 

// 假设 Chromium1 是 TChromium 组件实例
procedure TForm1.ButtonSimulateClickClick(Sender: TObject);
var
  Event: TCefMouseEvent;
begin
  // 1. 首先确保浏览器已加载完成（在 TChromium.OnLoadEnd 事件中操作更安全）
  if not Chromium1.Browser.IsValid then Exit;

  // 2. 设置鼠标事件参数（假设点击坐标 (100, 200)）
  Event.x := 100;
  Event.y := 200;
  Event.modifiers := 0; // 无修饰键

  // 3. 发送鼠标按下和抬起事件，模拟左键点击
  Chromium1.Browser.Host.SendMouseClickEvent(@Event, MBT_LEFT, False, 1); // 按下
  Chromium1.Browser.Host.SendMouseClickEvent(@Event, MBT_LEFT, True, 1);  // 抬起

  // 或者，更简单的方式：注入 JavaScript 来点击元素
  Chromium1.Browser.MainFrame.ExecuteJavaScript('document.querySelector("#myButton").click();', '', 0);
end;

6.3 无头模式与自动化测试

对于后台自动化（如爬虫、测试），可以使用无头模式。 

# 运行你编译的 Chromium 在无头模式下，并打开远程调试端口
out/Default/chrome --headless --disable-gpu --remote-debugging-port=9222 https://example.com

然后，你可以使用任何支持 Chrome DevTools Protocol (CDP) 的库（如 Python 的 puppeteer 或 selenium ）连接到 localhost:9222 来控制这个无头浏览器实例，实现复杂的模拟点击、表单填写、截图等操作。

7. 常见问题与排查思路

在 Chromium 源码之旅中，你几乎一定会遇到以下问题。

问题现象 可能原因 排查与解决思路
fetch 或 gclient sync 失败，网络错误 1. 网络连接不稳定或被阻断。
2. 未正确配置代理。 		1. 配置代理 ：如前文所述，为 git 、 curl 和 gclient 设置可靠的代理。
2. 使用镜像 ：探索是否有可用的国内镜像源（但官方不提供，需社区维护）。
3. 分步重试 ：可尝试多次执行 gclient sync ，它支持断点续传。
编译过程中内存不足 (OOM) 系统物理内存或交换空间不足。 1. 减少并行任务 ：使用 ninja -j 4 -C out/Default chrome 代替 autoninja ，减少并发数。
2. 增加交换空间 ：在 Linux 上创建大的 swap 文件。
3. 使用更精简的配置 ：在 args.gn 中设置 is_component_build=true （组件化构建，但最终链接慢），或关闭某些非必需功能。
链接阶段失败，报错 undefined reference 1. 源码同步不完整或损坏。
2. 依赖未正确更新。 		1. 清理并重新同步 ： gclient sync -D --force 强制重新同步所有依赖（耗时）。
2. 检查 GN 配置 ：确保没有启用冲突或不存在的特性。
编译出的 Chrome 无法启动，或崩溃 1. 动态库缺失。
2. 系统依赖库版本不匹配。
3. 编译配置有误。 		1. 使用 ldd 检查 ：`ldd out/Default/chrome
CEF/ Delphi 中浏览器白屏或崩溃 1. CEF 二进制文件与组件版本不匹配。
2. CEF 资源文件（ Resources 、 Locales ）未放在正确路径。
3. 多线程消息循环未正确处理。 		1. 版本对齐 ：确保下载的 CEF 二进制版本与 CEF4Delphi 组件支持的版本严格一致。
2. 文件结构 ：保证 libcef.dll 、 Resources 等与你的可执行文件在相同目录或子目录下（取决于 CefResourcesDirPath 等设置）。
3. 遵循生命周期 ：在 Delphi 中，必须在主线程初始化和销毁 CEF，并正确处理消息循环（ Application.ProcessMessages 或 CEF 自带的消息泵）。

8. 最佳实践与工程建议

  1. 版本管理 ：为你的 Chromium 检出创建一个明确的标签或分支记录。编译一个特定的、经过测试的版本，并在项目中固定下来，避免随意更新 main 分支导致的不兼容。
  2. 增量编译 ：开发过程中，尽量使用增量编译。只修改你关心的模块（如 third_party/webrtc 下的文件），然后使用 autoninja -C out/Default webrtc 或更具体的目标来快速重建。
  3. CCache 加速 ：在 Linux/macOS 上，强烈建议安装并配置 ccache ，它可以缓存编译结果，极大加速后续的干净编译。 
    sudo apt install ccache
# 在 args.gn 中加入
# use_ccache = true
# ccache_wrapper = "/usr/bin/ccache"
  4. 定制化构建 ：通过 gn args 仔细研究可用的构建参数 ( gn args --list out/Default )。根据你的需求禁用不需要的功能（如 enable_media_session=false , enable_print_preview=false ），可以显著减少编译时间和二进制体积。
  5. 自动化脚本 ：将环境设置、代码同步、配置生成、编译命令封装成 Shell 脚本或 Python 脚本。这能保证流程的一致性，特别适合团队协作或持续集成（CI）环境。
  6. 安全与合规 ：如果你在产品中使用修改后的 Chromium 或 CEF，务必了解其开源许可证（主要是 BSD-3-Clause 等）。同时，密切关注 Chromium 的安全公告，并及时将你的代码基底更新到包含安全修复的版本。

从庞大的源码仓库中成功编译出 Chromium，并进一步将其能力应用到 WebRTC 集成或桌面应用自动化中，是一个极具成就感的过程。这套流程虽然初始配置繁琐，但一旦打通，就为你打开了一扇通往浏览器内核和现代 Web 平台深处的大门。后续你可以深入研究特定模块的代码，定制渲染逻辑，优化资源加载，甚至为 Chromium 开源项目贡献代码。

Logo
火山引擎视频云技术社区

邀请您加入社区

更多推荐

DLSS Swapper 使用指南：免费给游戏切换 DLSS 版本，5 步完成替换与回退

如果你的游戏内置的 DLSS 版本太旧，或想从新版退回旧版，DLSS Swapper 是为 Windows 玩家准备的免费开源工具。它扫描本机游戏库，识别每款游戏里 DLSS/FSR/XeSS 的当前版本（分别是 NVIDIA、AMD、Intel 的超分辨率方案），下载目标版本替换对应 DLL，替换前自动备份原文件。## 🛠️ 安装工具并配好运行环境- **操作要点**：用 winget

avatar 火山引擎视频云技术社区

TDesign Uniapp Progress 进度条组件完全指南：三种形态、状态管理与样式定制

TDesign Uniapp 组件库（位于 `packages/uniapp-components`）中的 Progress 进度条组件，用于直观展示任务当前的完成进度，是加载上传、批量任务、表单校验等场景的基础反馈组件。本文以 [Progress 官方文档](https://link.gitcode.com/i/84674a06801556334e3376ef91733337) 为主线，结合组件

avatar 火山引擎视频云技术社区

Grafana Mimir 中的日志依赖 klog：Go 分级日志库从 glog 迁移到 klog/v2 的完整实战指南

> klog 是 Kubernetes 生态中 Go 语言最常用的分级日志库，也是 [Grafana Mimir](https://link.gitcode.com/i/8b38489f17e7f6c6f14cd1d5acbd6362)（Prometheus 水平可扩展、高可用、多租户长期存储系统）通过间接依赖引入的底层日志组件。本文以仓库内置的 [klog v2.140.0 README](ht

avatar 火山引擎视频云技术社区