必须手动校验sha-256哈希值，因buffalo cli预编译包无数字签名；下载后需用shasum -a 256（linux/macos）或get-filehash（windows）比对github release页面所列值，且校验须在chmod +x后、移入path前完成。

Buffalo CLI 二进制包本身不提供内置的完整性校验命令（如 buffalo verify），必须依赖操作系统级工具手动比对哈希值——这是唯一可靠方式。

下载后必须核对 SHA-256 哈希值

Buffalo 官方在 GitHub Releases 页面 每个版本的描述中，都会明确列出 SHA256 校验值。你不能跳过这一步，也不能凭文件大小或名称判断是否完整。

• Linux/macOS：运行 shasum -a 256 buffalo（假设解压后二进制名为 buffalo）
• Windows PowerShell：运行 Get-FileHash buffalo -Algorithm SHA256
• 输出的哈希值必须与 GitHub Release 页面上标注的完全一致，包括大小写和空格

为什么不用数字签名？

目前 Buffalo CLI 的预编译二进制包 未附带代码签名证书（Windows 的 Authenticode 或 macOS 的 notarization）。这意味着：

Buffalo框架 1.0.1

Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。

下载

• 右键 Windows .exe 查看“数字签名”选项卡 → 会显示“此文件没有数字签名”或签名无效
• macOS 双击运行时触发 Gatekeeper 警告 → 属正常现象，不是损坏，但需你手动允许（右键→打开）
• 签名缺失不等于包被篡改，只是缺乏平台级信任链；此时 SHA-256 是唯一可信依据

go install 方式绕过哈希校验？

用 go install github.com/gobuffalo/cli/cmd/buffalo@latest 安装时，Go 模块系统会自动校验 sum.golang.org 提供的模块哈希，**但这只保证源码未被篡改，不保证最终编译出的二进制行为与预编译包一致**。

• 如果你需要与团队其他成员运行完全一致的 CLI 行为（比如特定版本的 buffalo dev 监听逻辑），应优先使用预编译包 + 手动 SHA-256 校验
• 若网络受限无法访问 GitHub Release 页面，且必须用 go install，请显式指定 commit 或 tag（如 @v0.18.13），避免 @latest 指向意料之外的变更

最易被忽略的一点：校验必须在 chmod +x 之后、移入 /usr/local/bin 之前完成——权限变更可能影响某些哈希工具的读取结果（尤其在容器或 CI 环境中）。