Thorium浏览器Windows平台编译指南

原创于 2025-06-07 09:07:05 发布 · 265 阅读

CC 4.0 BY-SA版权

Thorium浏览器Windows平台编译指南

thorium Chromium fork named after radioactive element No. 90. Windows and MacOS/Raspi/Android/Special builds are in different repositories, links are towards the top of the README.md. 项目地址: https://gitcode.com/gh_mirrors/th/thorium

前言

Thorium是一款基于Chromium的高性能浏览器，针对不同硬件平台进行了深度优化。本文将详细介绍在Windows平台上编译Thorium浏览器的完整流程，帮助开发者构建自己的定制版本。

系统要求

硬件配置

64位处理器
至少8GB内存（推荐16GB以上）
100GB以上可用磁盘空间（必须使用NTFS格式）

软件环境

Windows 10 1809或更新版本
Visual Studio 2022（17.0.0或更高版本）
Git Bash或其他兼容的Bash环境

开发环境配置

Visual Studio安装

安装Visual Studio 2022社区版
选择"使用C++的桌面开发"工作负载
勾选"MFC/ATL支持"子组件

对于ARM64平台构建，需要额外添加以下组件：

ARM64工具链
ARM64 MFC支持

Windows SDK安装

必须安装10.1.22621.2428版本的Windows 11 SDK，并确保同时安装对应的调试工具。注意Visual Studio 2022默认会安装22000版本SDK，需要手动取消并选择22621版本。

工具链准备

depot_tools配置

下载depot_tools工具包
解压到C:\src\depot_tools目录（注意保留.git目录）
将depot_tools目录添加到PATH环境变量开头
设置DEPOT_TOOLS_WIN_TOOLCHAIN=0环境变量
设置vs2022_install变量指向VS安装路径

Python环境检查

运行where python命令确认depot_tools提供的python.bat优先级最高。同时需要禁用Windows 10/11中的"App Execution Aliases"功能，避免与系统Python冲突。

代码获取

Chromium源码

配置Git全局设置：

git config --global user.name "Your Name"
git config --global user.email "your@email.com"
git config --global core.filemode false
git config --global branch.autosetuprebase always
git config --global core.longpaths true

创建源码目录：

cd / && cd src && mkdir chromium && cd chromium

获取Chromium源码：
```
fetch chromium
```

Thorium源码

在用户目录下克隆Thorium仓库：

git clone --recursive https://github.com/Alex313031/thorium.git

构建配置

源码准备

更新Thorium到最新版本：
```
./trunk.sh
```
检查Chromium版本：
```
./version.sh
```
应用Thorium修改：
```
./setup.sh
```

GN配置

创建构建目录：
```
gn args out\thorium
```
在打开的编辑器中配置构建参数，特别注意：
- PGO配置文件路径
- API密钥配置（可选）
- 平台特定优化选项

构建过程

执行完整构建命令：

autoninja -C out\thorium thorium chromedriver thorium_shell setup mini_installer -j8

其中-j8参数可根据CPU核心数调整，建议设置为物理核心数的1-2倍。

安装与运行

构建完成后，可通过以下方式运行或安装：

直接运行：
```
out\thorium\thorium.exe
```
使用安装包安装：
```
out\thorium\mini_installer.exe
```

常见问题处理

构建错误排查

检查环境变量配置是否正确
确认磁盘空间充足
验证工具链版本兼容性
查看构建日志定位具体错误

性能优化

关闭Windows Defender实时保护
使用RAMDisk加速构建
调整Ninja并行任务数

后续维护

代码更新

更新Chromium代码：
```
gclient sync
```

更新Thorium代码：

git pull --recurse-submodules origin main

重新应用修改：
```
./setup.sh
```

结语

通过本文的详细指导，开发者应该能够在Windows平台上成功构建Thorium浏览器。构建过程虽然复杂，但遵循步骤操作通常能够顺利完成。如遇问题，建议查阅Thorium项目提供的调试文档或参与社区讨论获取支持。

构建自定义浏览器不仅能够获得性能优化的体验，也为深入理解现代浏览器架构提供了绝佳机会。祝您构建顺利！

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考