在 Windows 中解决 `zig fetch` 的 `TlsInitializationFailed` 错误

在 Windows 中解决 zig fetch 的 TlsInitializationFailed 错误,可参考以下分步解决方案:


1. 配置 Git 使用 Windows 原生 TLS 后端 (推荐)

Zig 默认调用 Git 时可能因 TLS 后端不兼容导致失败。通过以下命令强制 Git 使用 Windows 内置的 SChannel 安全层:

powershell 复制代码
git config --global http.sslBackend schannel

此设置利用系统证书存储,避免跨平台 TLS 库冲突 。


2. 更新 Zig 和 Git 到最新版本


3. 验证系统证书信任

若使用自签名证书或企业内网证书:

  1. 打开 控制面板 > 管理工具 > 证书管理器。
  2. 在 受信任的根证书颁发机构 中导入 GitHub 或目标服务器的根证书。
  3. 重启终端后重试。

4. 设置环境变量强制 TLS 协议

在 PowerShell 中执行以下命令,限制 Git 使用 TLS 1.2(兼容性最佳):

powershell 复制代码
$env:GIT_SSL_VERSION = "tlsv1.2"
$env:ZIG_PREFER_SYSTEM_GIT = "1"  # 强制 Zig 使用系统 Git
zig fetch --save git+https://github.com/david-vanderson/dvui#main

5. 手动克隆仓库(绕过网络问题)

若网络限制导致 TLS 握手失败:

  1. 手动克隆仓库 :

    powershell 复制代码
    git clone https://github.com/david-vanderson/dvui.git
  2. 在 build.zig 中引用本地路径 :

    zig 复制代码
    const dvui_dep = b.dependency("dvui", .{
        .path = "D:\\nullclaw\\dvui"  # 替换为实际路径
    });

6. 检查防火墙/代理设置

  • 禁用防火墙测试 :
    临时关闭 Windows Defender 防火墙,确认是否拦截 Git 流量。

  • 配置代理 :
    若通过代理访问,设置 Git 代理:

    powershell 复制代码
    git config --global http.proxy http://proxyuser:proxypwd@proxyserver:port

7. 修复系统时间同步

TLS 依赖准确时间,若系统时间偏差超过 5 分钟会导致证书失效:

powershell 复制代码
# 同步时间(需管理员权限)
w32tm /resync

8. 使用 Zig 的 --verbose 调试

获取更详细的错误信息以定位问题:

powershell 复制代码
zig fetch --save git+https://github.com/david-vanderson/dvui#main --verbose

引用来源

  • Git TLS 后端配置方法
  • 系统证书信任与网络代理设置
  • Zig 依赖管理最佳实践
相关推荐
xx z9 小时前
Radmin LAN 怎么联机(虚拟局域网建房与加入教程)
windows·工具·软件
广东程序猿小展10 小时前
谷歌相机配置文件怎么导入(GCam 配置导入与不生效排查)
windows·工具·软件
李小白杂货铺2 天前
Windows 桌面 GUI 原型快速开发技术选型指南(Mac 开发 + Windows 交付场景)
windows·原型·gui·原型开发·技术选型·快速开发·技术路线
承渊政道2 天前
magic-resume简历工具教程:Windows部署、在线编辑与远程访问
windows·远程访问·在线编辑·简历制作·工具教程·magic-resume
观察员2 天前
告别频繁锁屏:5行 PowerShell 脚本实现 Windows 自动防休眠
windows·命令行
Funlang2 天前
在 Windows 95 上写前端
前端·javascript·windows
一切皆有可能!!3 天前
【SoduWork测评】本机跑源码,找到并修了7个Bug
windows·开源·bug·ai编程·soduwork
xx z3 天前
打开游戏提示 d3dx9_43.dll 缺失怎么办(DirectX 修复步骤)
windows·游戏·工具·软件
如夏倾城3 天前
五大远程桌面协议:RDP、SSH、VNC/RFB、Citrix ICA/HDX 与 VMware Blast Extreme
运维·windows·网络协议·安全·自动化·ssh·远程工作