被 CGO 交叉编译折磨的一个周末
原文中文，约2900字，阅读约需7分钟。
📝
内容提要
在使用 zig cc 交叉编译 CGO 项目时，rpath 设置失效，导致无法加载 .so 文件。最终通过 Docker buildx 在 ARM64 环境中编译，成功解决了该问题。
🔎
延伸解读
交叉编译的挑战
在使用 zig cc 进行 CGO 项目的交叉编译时，rpath 设置失效是一个常见问题。这意味着在不同环境中运行时，程序可能无法找到所需的 .so 文件，导致启动失败。开发者需要特别注意编译和运行环境的一致性，确保路径设置正确。
Docker buildx 的优势
使用 Docker buildx 编译 ARM64 环境的应用程序，可以有效避免交叉编译带来的复杂性。通过在容器中构建，开发者可以确保所有依赖和环境配置一致，从而提高构建的成功率和运行的稳定性。这种方法尤其适合需要在不同架构上部署的项目。
升级带来的风险
在项目中进行库的升级时，可能会引入新的问题。例如，升级 charabia 后，服务启动失败，提示找不到 .so 文件。这提醒开发者在进行依赖更新时，需进行充分的测试，以避免因版本不兼容导致的运行时错误。
❓
Q&A
使用 zig cc 交叉编译 CGO 项目时遇到的主要问题是什么？
主要问题是 rpath 设置失效，导致无法加载 .so 文件。
如何解决 zig cc 交叉编译时的 rpath 问题？
通过使用 Docker buildx 在 ARM64 环境中编译，绕过了交叉编译的问题。
在交叉编译 CGO 项目时，如何设置 .so 文件的加载路径？
可以通过 LDFLAGS 设置不同的 .so 加载路径，在编译时使用开发环境的路径，运行时使用二进制文件同级的 lib 目录。
为什么在升级 charabia 后服务启动失败？
因为升级后，程序仍试图从本地绝对路径加载 .so 文件，rpath 设置未生效。
Docker buildx 在解决交叉编译问题中有什么优势？
Docker buildx 可以在目标 ARM64 环境中直接编译，避免了交叉编译带来的复杂性。
在使用 zig cc 交叉编译时，如何检查 .so 文件的加载情况？
可以使用 ldd 命令检查二进制文件，查看程序是否正确加载 .so 文件。
🏷️
