Brigadier 完整实战：一条命令搞定 Mac 的 Boot Camp 驱动下载与安装

Brigadier 完整实战：一条命令搞定 Mac 的 Boot Camp 驱动下载与安装

【免费下载链接】brigadierFetch and install Boot Camp ESDs with ease.项目地址: https://gitcode.com/gh_mirrors/bri/brigadier

在 Mac 上装好 Windows 只是第一步，真正磨人的是驱动：键盘没反应、触控板失灵、网卡罢工……要找到匹配机型的 Boot Camp 驱动，传统做法是在官网手动翻型号、逐个下载、多层解压、再手动安装，折腾一小时是常事。开源工具Brigadier把这条链路压缩成一条命令：自动识别 Mac 型号、定位匹配的 Boot Camp 驱动安装包、层层解包，甚至能在 Windows 上直接静默安装。本文就从零开始，带你完整跑通这套流程。

先弄清它到底解决什么问题

传统手动流程有多麻烦

Apple 并不提供一个"通用驱动包"，而是把 Boot Camp 驱动按机型拆成若干个 ESD 安装包（ESD 即电子软件分发格式，可以理解成 Apple 的"安装包快递"）。手动操作大致要经历：

1. 查清楚自己的 Mac 型号标识符（比如MacBookPro15,1）；
2. 去 Apple 软件更新目录或支持页面找到覆盖该机型的 ESD；
3. 下载动辄几 GB 的.pkg文件；
4. 用 7-Zip 之类工具逐层解压出真实驱动；
5. 手动运行 MSI 安装器，祈祷路径没搞错。

Brigadier 做了什么

Brigadier 是一个 Python 编写的跨平台脚本（另有 PowerShell 移植版），它会：

• 自动探测当前机器的 Mac 型号，无需你手动查标识符；
• 从 Apple 软件更新服务器（或你指定的内网服务器）抓取软件目录，匹配机型对应的 Boot Camp ESD；
• 在 Windows 上借助 7-Zip 逐层解包，在 macOS 上则用系统自带的 pkgutil 和 tar 完成同样工作；
• 加上--install参数后，直接调用 msiexec 静默安装驱动，装完自动清理临时文件。

核心链路一图看懂

整个工具的本质是一条"五步流水线"，理解它你就能预判任何一步出错时该查哪里：

第一次运行：Windows 上的五分钟实战

获取工具

如果你不想装 Python，可直接使用官方发布页的预编译brigadier.exe。想从源码跑或自己折腾，克隆仓库即可：

git clone https://gitcode.com/gh_mirrors/bri/brigadier cd brigadier

最基础的一条命令

brigadier.exe

不接任何参数时，它会自动识别本机型号，把驱动下载并解压到当前目录下一个名为BootCamp-产品编号（如BootCamp-041-1234）的文件夹里。对普通用户意味着什么：你不再需要关心"我的电脑到底是哪个型号、该下哪个包"，跑完打开文件夹就是现成的驱动文件。

一条命令直接装好

brigadier.exe --install

--install是 Windows 专属参数，它会在下载解压完成后自动调用msiexec静默安装 64 位驱动，安装结束自动清理下载和解压产物。这是最推荐的一键玩法：一条命令，从识别到装完，中途不需要任何人工干预。

macOS 上的用法

macOS 上 Brigadier 负责"取货"——下载并解出驱动镜像：

chmod +x brigadier ./brigadier --output ~/bootcamp-drivers

跑完会在指定目录留下WindowsSupport.dmg驱动镜像，方便你刻盘或复制到 Windows 侧使用。

幕后拆包：Apple 的"套娃"压缩结构

Apple 的 Boot Camp ESD 文件包得极其迂回，整个结构就像层层套娃的快递：

1. 外层BootCampESD.pkg（XAR 归档格式）；
2. 拆开是Payload（gzip 压缩流）；
3. 再拆是Payload~（cpio 归档）；
4. 里面藏着WindowsSupport.dmg磁盘映像；
5. 最后从 DMG 里提取真正的驱动目录。

Brigadier 的省心之处在于：在 Windows 上如果检测到系统没装 7-Zip，它会自动下载安装，完成拆包后再静默卸载，全程不污染你的环境。这意味着你完全不需要知道 XAR 是什么，这些格式对你而言只是一层会自动剥开的包装纸。

常见误区与避坑清单

误区一：没有网卡驱动也敢直接跑

Brigadier 需要联网下载，所以系统必须已有可用的网络驱动。最稳妥的办法是在做系统镜像时，把 Boot Camp 里的网卡驱动预先放进C:\Windows\INF目录——Windows 会自动搜索这个目录安装未知硬件驱动，这样第一次进系统就有网了。

误区二：以为它支持 32 位 Windows

目前仅支持 64 位 Windows 的自动安装。32 位系统跑--install会被直接拒绝，需要驱动请另想办法。

误区三：--install时想指定别的机型

注意：--install会忽略--model参数。因为 Boot Camp 安装器本身会校验硬件机型，指定其他型号没有意义。想给特定机型下载驱动，只下载不安装即可。

误区四：--keep-files乱用

--keep-files只在配合--install时才有意义，它让工具装完驱动后保留下载文件而不是清理。单独使用会被报错拦截。

需要知道的局限

项目作者在文档中如实声明：某些型号与驱动组合在 Boot Camp 6 上的静默安装效果不理想，部分问题来自 Apple 侧而非工具本身。如果你追求 100% 完美的无人值守安装，建议先用一台真机验证再批量推广。

虚拟机测试的隐藏彩蛋

想在虚拟机里测安装？msi-transform目录里附带了set_nocheck.mst转换文件和配套的WiUseXfm.vbs脚本，可以给 MSI 打上NOCHECK调试属性，绕过"必须是 Apple 真机"的硬件校验：

cscript WiUseXfm.vbs \path\to\Drivers\Apple\BootCamp.msi set_nocheck.mst

进阶玩法：让它更贴合你的场景

给指定型号下载驱动

想给其他型号准备驱动，用--model指定即可，而且可以重复传入实现一次跑多个型号：

brigadier.exe --model MacBookPro15,1 --model iMac19,1 --output ./drivers

多个候选包时锁定版本

某些机型会匹配到多个 ESD，默认按发布时间取最新。想精确指定某版，先用--product-id手动选择（格式如031-0787）。

接入企业内网软件更新服务器

在企业里想让所有 Mac 走内部服务器下载，只需在脚本同目录放一个brigadier.plist配置文件，写入CatalogURL指向内网软件更新目录即可。对批量部署来说，这能显著提升下载速度与安全性，也可以避免对外网的依赖。

集成到 Sysprep 自动化部署

Brigadier 设计上就支持作为 Sysprep 的 FirstLogonCommand 运行：同一份系统镜像可以部署到不同 Mac 机型，首次登录时自动拉取匹配驱动。它还内置了一个细节处理——检测到当前工作目录是\Windows\system32时，会自动把输出目录切到系统盘根目录，绕开 32/64 位路径重定向导致的 MSI 安装失败问题。

构建独立 exe

需要在没有 Python 的 Windows 机器上使用？仓库里的build_windows_exe.py会用 PyInstaller 打包出独立的brigadier.exe。注意源码注释里也提醒：这套构建脚本目前需要现代化改造，动手打包前请先以官方 README 说明为准。

版本与维护现状

当前版本为 0.2.6，最近的更新很务实：

• 引入 certifi 证书包，修复老版本 Windows 访问 7-Zip 下载站时的证书问题；
• 7-Zip 升级到 22.01；
• 新增-V/--version参数输出工具版本；
• 更新预编译 exe 以兼容较新的 TLS 版本。

项目从 2013 年诞生至今持续迭代，除了 Python 主脚本，还有社区贡献的 PowerShell 移植版brigadier.ps1，接口设计保持一致（-Install、-Model、-CatalogURL等），Windows 管理员可以按熟悉的方式选用。需要声明的是：作者个人维护精力有限，对静默安装的兼容性并非尽善尽美，遇到问题建议先看仓库文档中的注意事项再判断是否值得深挖。

下一步行动

如果你正被"Mac 装 Windows 没驱动"折磨，现在就动手：

1. 克隆仓库：git clone https://gitcode.com/gh_mirrors/bri/brigadier；
2. Windows 上直接运行brigadier.exe --install一键安装，或先不带参数只下载看看产物；
3. 遇到异常时，对照上文"避坑清单"逐条排查，重点确认网卡驱动已就绪、系统是 64 位；
4. 想深入了解内部机制，翻一翻仓库里的 README 和 CHANGELIST，改动历史和已知限制都写得清楚。

Brigadier 的价值不在于代码有多炫，而在于它把一条七拐八绕的手工流程，压缩成了一个"跑一下就好"的动作。省下的不只是半小时，还有大量因型号搞错、版本选错而踩坑的概率。现在就跑一次，让驱动安装这件事彻底从你的待办清单里消失。

【免费下载链接】brigadierFetch and install Boot Camp ESDs with ease.项目地址: https://gitcode.com/gh_mirrors/bri/brigadier