如何在crates.io发布可沿用旧包名引用的分叉Rust包？

先说结论：没法直接在crates.io发布包名和代码引用不一致的项目 #

crates.io要求发布的包名必须和Cargo.toml里的name字段完全一致，而且Rust代码里的use、extern crate这类引用是绑定到包名的，不存在“别名发布”的机制。所以你不能在crates.io上用新包名发布，却让代码里依然用原包名正常编译。

可行方案：用依赖别名+内部导出实现无缝切换 #

如果想把分叉包放到crates.io上，同时让用户不用改代码就能切换过来，可以这么做：

1. 修改分叉包的Cargo.toml
   把name字段改成你的新包名（比如new_name），其他配置保持不变：

   [package]
   name = "new_name"
   version = "1.0.0"
   # 其他原有配置保留
   

2. 在lib.rs中添加导出别名
   在包的根文件lib.rs开头加入一行代码，让外部可以通过原包名访问当前包内容：

   pub use crate as old_name;
   

3. 指导用户用依赖别名引入你的包
   用户在他们的Cargo.toml里可以通过别名方式添加依赖，完全不用修改自身代码：

   old_name = { package = "new_name", version = "1.0.0" }
   

   这样用户代码里的use old_name::*;等写法依然正常工作，完全感知不到包名变更。

针对测试代码的重构建议 #

你提到大部分原包名引用出现在测试中，可以通过以下方式减少修改量：

• 给测试文件统一设置别名
  在每个测试文件的最开头添加一行：

  use crate as old_name;
  

  这样测试里所有old_name的引用都会自动指向当前包，无需逐个修改测试用例。

• 在测试模块内批量处理引用
  如果测试中有大量use old_name::xxx;的写法，可以在测试模块顶部统一导入：

  mod tests {
      use crate as old_name;
      use old_name::some_module;
      use old_name::another_module;
  
      // 原有测试代码无需修改
  }
  

这种方式仅需少量改动，就能让所有测试适配新包名，同时保留原有的测试逻辑。

内容的提问来源于stack exchange，提问作者Audrius Meškauskas