如何无需发布至crates.io生产环境测试Rust包发布流程？

我首次尝试在crates.io发布Rust包，需完成GitHub Actions配置、令牌设置、发布流程搭建等工作，还要确保文档在crates.io上的渲染效果符合预期。此前在PyPi发布时，我先在测试环境完成完整测试，可安全发布半成品包且能快速删除，不会造成混淆。我绝对不想在crates.io生产环境中测试，因为crates.io的清理工作几乎无法完成。请问是否存在无需将包发布至crates.io生产环境，就能完整测试发布流程并查看结果的方法？

使用--dry-run存在局限性，无法完成以下下游验证：

• 验证内容在crates.io网站上的渲染效果是否符合预期
• 验证CI流水线是否正确注入了构建所需的版本号
• 最终验证从其他项目拉取已发布的crate是否可正常使用（无遗漏的公共项）

此外我也不确定--dry-run成功但实际发布失败的可能性范围，毕竟“所有检查”必然存在边界。

1. 搭建测试用crates注册表 #

这是最接近crates.io生产环境的完整测试方案，分为两种形式：

• 本地注册表：
  1. 初始化一个本地git仓库作为索引，添加符合规范的config.json（参考crates.io索引的配置格式）
  2. 在cargo config中注册这个本地注册表
  3. 执行cargo publish --registry=your-local-registry将包发布到本地注册表
  4. 创建测试项目，将本地注册表设为依赖源，测试拉取、编译、使用全流程
• 远程测试注册表：使用社区维护的crates测试服务，支持发布测试包、预览文档渲染，且可随时清理测试内容，完全模拟线上环境的行为。

2. 文档渲染预验证 #

crates.io的文档渲染逻辑和cargo doc高度一致，无需发布即可验证：

• 执行cargo doc --open生成本地文档，预览效果与crates.io线上表现基本一致
• 若需更精准模拟，可使用mdbook工具（crates.io文档基于此渲染），将README和crate文档按规则排版后预览。

3. CI流水线与版本号验证 #

针对CI流程的验证，可在预发布阶段完成：

• 在CI中添加步骤，执行cargo metadata --format-version=1 | jq '.packages[] | select(.name=="your-crate-name") | .version'提取版本号，验证是否符合预期
• 使用测试令牌（非生产环境令牌）执行cargo publish --dry-run，验证CI中环境变量、令牌传递是否正常
• 执行cargo build --release并检查构建产物的版本信息，确认版本注入无误

4. 跨项目拉取测试 #

无需发布到crates.io，即可验证其他项目拉取你的包的流程：

• 使用cargo add --path=/path/to/your/crate将本地包作为依赖添加到测试项目，验证公共项的可用性、编译是否正常
• 若使用本地注册表，直接从本地注册表拉取依赖，完全模拟线上拉取逻辑

关于--dry-run的局限性：它仅能完成包结构、依赖合法性、版本格式等预检查，无法覆盖线上环境特有的索引同步、网络问题、文档渲染细微差异等场景，因此上述方案能更全面地覆盖你的测试需求。

内容的提问来源于stack exchange，提问作者Philip Couling