如何将第三方可执行文件打包进Go可执行文件？含Chromium嵌入需求

1. 如何将第三方可执行文件打包进Go可执行文件 #

可以通过go:embed嵌入Chromium二进制文件，再在运行时将其写入临时目录并执行，具体步骤如下：

步骤1：嵌入Chromium二进制 #

将Chromium可执行文件按平台分类存放在项目目录中，使用go:embed结合build tags嵌入对应平台的文件：

//go:embed linux/chromium
//go:build linux
var chromiumBinary []byte

//go:embed windows/chrome.exe
//go:build windows
var chromiumBinary []byte

//go:embed macos/Chromium.app/Contents/MacOS/Chromium
//go:build darwin
var chromiumBinary []byte

步骤2：运行时提取并执行嵌入的二进制 #

多数操作系统无法直接运行内存中的可执行文件，需将嵌入内容写入临时文件并赋予执行权限，再配置chromedp使用该路径：

package main

import (
	"io/ioutil"
	"os"
	"path/filepath"

	"github.com/chromedp/chromedp"
)

func main() {
	// 创建临时目录，程序退出时自动清理
	tmpDir, err := os.MkdirTemp("", "chromium-*")
	if err != nil {
		panic(err)
	}
	defer os.RemoveAll(tmpDir)

	// 根据系统设置Chromium临时路径
	chromePath := filepath.Join(tmpDir, "chromium")
	if os.PathSeparator == '\\' {
		chromePath = filepath.Join(tmpDir, "chrome.exe")
	}

	// 写入二进制文件并设置执行权限
	err = ioutil.WriteFile(chromePath, chromiumBinary, 0755)
	if err != nil {
		panic(err)
	}

	// 配置chromedp使用临时路径的Chromium
	opts := []chromedp.ExecAllocatorOption{
		chromedp.ExecPath(chromePath),
		chromedp.Flag("no-sandbox", true),
		chromedp.Flag("headless", true),
	}

	// 初始化chromedp上下文并执行任务
	ctx, cancel := chromedp.NewExecAllocator(opts...)
	defer cancel()

	ctx, cancel = chromedp.NewContext(ctx)
	defer cancel()

	// 示例任务：访问网页并截图
	var buf []byte
	err = chromedp.Run(ctx,
		chromedp.Navigate("https://example.com"),
		chromedp.CaptureScreenshot(&buf),
	)
	if err != nil {
		panic(err)
	}

	err = ioutil.WriteFile("example.png", buf, 0644)
	if err != nil {
		panic(err)
	}
}

2. 这是否是通用做法？还是应由用户自行安装依赖？ #

两种方案各有优劣，需根据场景选择：

嵌入二进制的适用场景 #

• 面向非技术用户：追求开箱即用，降低使用门槛，无需用户手动安装依赖。
• 离线环境分发：用户机器无法联网下载资源，必须离线运行。

但嵌入方案存在明显缺点：

• 程序体积暴增：Chromium本身体积超100MB，会导致Go可执行文件变得异常庞大。
• 跨平台维护成本高：需为Windows、Linux、macOS分别打包对应版本的Chromium，还要处理不同平台的兼容性问题（如Linux系统库依赖、macOS版本要求）。
• 版本更新繁琐：Chromium的安全更新或功能迭代，需要你重新打包发布程序，用户无法自行更新。

用户自行安装依赖的通用做法 #

• 面向开发者/技术用户：这类用户有能力自行安装Chromium或Chrome，程序体积小巧，且用户可自主管理浏览器版本。
• 轻量化分发需求：避免大体积文件带来的传输和存储成本。

折中推荐：让chromedp自动下载Chromium #

chromedp支持自动检测并下载对应平台的Chromium到用户机器缓存目录，无需嵌入也无需用户手动安装，示例配置：

opts := []chromedp.ExecAllocatorOption{
	chromedp.NoDefaultBrowserCheck,
	chromedp.Flag("headless", true),
}

这种方案兼顾易用性和轻量化，是多数场景下的最优选择。

内容的提问来源于stack exchange，提问作者Chiamin