如何将Golang+Muon UI应用打包为Linux和Windows平台的单执行文件

1. 第三方CLI工具方案（推荐，适配CI流程） #

不需要修改业务代码，直接在构建阶段调用工具完成打包，完全支持Docker环境下的GitLab CI流水线运行：

• Linux平台：使用appimagetool工具，将编译好的Go二进制、Ultralight的*.so依赖、基础桌面配置文件打包为单个AppImage可执行文件，用户侧无需额外安装依赖即可直接运行。也可以选择更轻量的makeself，将二进制和依赖库打包为自解压Shell脚本，运行时自动释放依赖加载。
• Windows平台：使用Enigma Virtual Box的CLI版本，或者自定义NSIS静默打包脚本，将exe主程序和*.dll依赖打包为单文件可执行程序，两个工具均支持无GUI的命令行调用，可直接集成到CI流程。

2. Golang原生embed方案（无额外工具依赖） #

使用Go 1.16+自带的embed包即可实现，无需引入第三方构建工具：

• 按平台分类存放Ultralight依赖库，比如./assets/linux/下放Linux版本的*.so，./assets/windows/下放Windows版本的*.dll
• 通过构建标签区分不同平台的嵌入逻辑，示例代码如下：

//go:build linux
// +build linux

package main

import _ "embed"

//go:embed assets/linux/libultralight.so
var ultralightLib []byte

//go:build windows
// +build windows

package main

import _ "embed"

//go:embed assets/windows/ultralight.dll
var ultralightLib []byte

• 程序启动逻辑前置：先将嵌入的库文件写入系统临时目录（Linux对应/tmp，Windows对应%TEMP%），再通过os.Setenv修改动态库加载路径（Linux修改LD_LIBRARY_PATH，Windows修改PATH），再启动主业务逻辑即可。

注意：可以在程序退出时新增临时目录清理逻辑，避免依赖库文件残留占用磁盘空间。

3. cgo静态链接方案（适用性有限） #

该方案可以生成真正无外部依赖的单二进制文件，但有前置限制：Ultralight官方需要提供对应平台的静态编译版本库（Linux下为*.a静态库，Windows下为*.lib静态库）。

• 满足前置条件的前提下，只需要在cgo的LDFLAGS配置中添加静态链接参数，Linux下加-static标志，Windows下指定静态.lib文件的路径即可。
• 跨平台构建需要配置对应交叉编译工具链，Linux环境下编译Windows版本可使用mingw-w64工具链，完全支持Docker CI环境部署。

坑点提醒：目前Ultralight官方默认分发的都是动态库，未公开提供静态编译版本，没有静态库资源的情况下该方案无法落地，不推荐优先尝试。

CI流程适配建议 #

可以提前制备包含Go环境、对应打包工具、交叉编译链的Docker镜像，在GitLab CI中拆分两个独立Job分别构建Linux和Windows版本，全程无人工干预即可自动产出两个平台的单执行文件。

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