GitButler 在 Windows 上构建看起来卡在 openssl-sys crate 上怎么排查并配置 Perl？

GitButler 在 Windows 上构建看起来卡在 openssl-sys crate 上怎么排查并配置 Perl？

【免费下载链接】gitbutlerThe GitButler version control client, backed by Git, powered by Tauri/Rust/Svelte项目地址: https://gitcode.com/GitHub_Trending/gi/gitbutler

在 Windows 上从源码构建 GitButler（Tauri + Rust 桌面应用）时，Cargo 的输出可能会在openssl-sys这个 crate 上长时间没有任何动静，看起来像挂死了。这篇基于仓库内 DEVELOPMENT.md 的 "Building on Windows" 章节，说明如何判断这种“卡住”是否只是表象，以及如何安装并配置 Perl，让openssl-sys的构建顺利进行。

先判断：构建是否真的卡死了

文档明确给出了解释：构建“看起来”在openssl-sys上挂起，实际上并没有。原因是 Cargo 无法汇报底层正在进行的 C/C++ 编译状态，而 openssl 本身体积很大，编译需要相当长的时间。也就是说，在openssl-sys阶段长时间没有新输出是预期现象，不需要立刻干预，等待编译完成即可。

但如果你是在 Windows 上第一次搭建构建环境，那么openssl-sys有一个文档明确列出的硬性前置条件：

A Perl interpreter is required to be installed in order to configure theopenssl-syscrate.

即：必须安装一个 Perl 解释器，openssl-sys才能完成配置。此外，Windows 上整体构建还需要一套可用的基于 MSVC 的工具链及相关原生依赖（文档在 CLI 构建的脚注中说明，cargo build会连带构建git2等依赖 vendored openssl 的原生组件）。

安装 Perl 并确认它在 PATH 上

文档推荐并实际验证过的方案是 Strawberry Perl（"We've used Strawberry Perl without issue"），安装后确认perl在PATH上可用：

• 安装完成后perl默认会进入PATH，但需要重启终端才能生效；
• 如果你使用 Scoop 作为包管理器，可以直接用文档给出的命令安装：

scoop install perl

通过 OPENSSL_SRC_PERL 指定 Perl 路径

为了让构建找到 Perl，需要把 Perl 安装路径导出为环境变量OPENSSL_SRC_PERL。在 Git Bash 中执行：

export OPENSSL_SRC_PERL="c:/Strawberry/perl/bin/perl.exe"

上面路径是文档中的示例值（Strawberry Perl 安装到c:/Strawberry时的位置）。如果你的 Perl 安装位置不同，把值替换为你本机的 perl.exe 实际路径即可。

如果希望这个设置永久生效，文档给出追加到~/.bash_profile的做法。注意这条命令会向你的 shell 配置文件末尾追加一行，属于修改本地环境文件：

echo 'export OPENSSL_SRC_PERL="c:/Strawberry/perl/bin/perl.exe"' >> ~/.bash_profile

重新执行构建并验证

配置完成后，验证与继续构建分两步：

1. 验证 Perl 可用：文档要求perl在PATH上（新终端里确认能调用到perl即可）。
2. 重新运行构建。构建 GitButler 的命令与平台无关的部分沿用文档通用流程，例如先做一次整体编译：

cargo build

要产出夜间版（nightly）风格的发布资产，则执行文档 "Building" 一节给出的命令：

pnpm tauri build --features devtools,builtin-but,disable-auto-updates --config crates/gitbutler-tauri/tauri.conf.nightly-local.json

其中配置文件即仓库中的 crates/gitbutler-tauri/tauri.conf.nightly-local.json。构建进入openssl-sys的 C 编译阶段后输出会再次变慢或暂停一段时间，按前文说明，这属于编译耗时而非故障。

可选分支：ARM Windows 交叉编译到 x86_64-MSVC

如果你是在 ARM 版 Windows（例如 Apple Silicon 上的 Parallels 虚拟机）上构建，文档指出gitbutler-git的windows依赖目前不能在 ARM 上编译，需要交叉编译到 x86_64-MSVC。此时除了OPENSSL_SRC_PERL，文档还要求先设置以下变量（前提是系统已安装 x86-64 的 MSVC）：

export TRIPLE_OVERRIDE=x86_64-pc-windows-msvc export CARGO_BUILD_TARGET=x86_64-pc-windows-msvc # for good measure export OPENSSL_SRC_PERL="c:/Strawberry/perl/bin/perl.exe"

该场景的完整交叉编译说明（含--target参数的注意事项）见 DEVELOPMENT.md 的 "Crosscompilation" 小节，本文不展开。

仍未解决时

文档没有描述openssl-sys构建失败时的具体报错文本，因此这里不猜测错误形态。如果确认 Perl 已安装、在PATH上、OPENSSL_SRC_PERL已正确导出而构建仍然不通过，可以按文档 Troubleshooting 一节的建议，带着你的系统和报错信息到项目的 GitHub Issues 中查找或提交新问题。

【免费下载链接】gitbutlerThe GitButler version control client, backed by Git, powered by Tauri/Rust/Svelte项目地址: https://gitcode.com/GitHub_Trending/gi/gitbutler