Go中模块重命名是修改go.mod的module声明以变更导入路径，需同步更新版本、文档并可选设转发层；仅改别名或仓库地址无效，必须确保module path与version共同唯一标识模块。
在 Go 中，模块重命名本质是修改 module path（即 go.mod 文件中的 module 声明），从而改变该模块被其他项目导入时使用的路径。这不是简单的本地别名，而是影响整个依赖生态的正式变更。
理解 module path 与导入路径的关系
Go 的导入路径直接对应模块的 module 声明值。例如：
go.mod 中写的是：
module github.com/oldorg/mylib
那么所有外部代码都必须用 import "github.com/oldorg/mylib" 才能引用它。
若想让别人改用新路径（比如迁移到新组织），就必须把 module 行改成：
module github.com/neworg/mylib
之后，新用户应使用 import "github.com/neworg/mylib" —— 这才是真正的“重命名”。
安全完成模块重命名的步骤
直接改 go.mod 不够，还需同步处理版本、发布和兼容性问题：
- 更新 go.mod 中的 module 行：确保新路径符合语义（如域名、组织名正确）
- 打一个新主版本 tag（如 v2.0.0）：如果旧路径还在用 v1.x，新路径建议从 v2.0.0 起步，避免版本冲突
- 更新文档和示例代码：明确告知用户导入路径已变，并提供迁移说明
-
（可选）保留旧模块作为转发层：在
github.com/oldorg/mylib下放一个仅含package mylib和重导出的模块，提示用户迁移到新路径（需注意 Go 不支持自动重定向）
常见误区与注意事项
以下操作 不会 实现模块重命名：
- 仅修改本地 import 别名（如
import newlib "github.com/oldorg/mylib"）—— 这只是包内变量名，不影响模块身份 - 只改仓库地址但不改
go.mod中的module行 —— 导入路径仍指向旧地址，Go 工具链会报错或拉错版本 - 未升级主版本就复用 v1.x tag —— 可能导致
go get混淆两个不同 module path 下的同名版本
Go 模块系统以 module path + version 为唯一标识，二者缺一不可。
验证是否生效
修改后，在另一个项目中尝试：
go get github.com/neworg/mylib@v2.0.0
然后写代码：
import "github.com/neworg/mylib"
能
成功构建且调用正常，说明重命名已完成。同时检查 go.sum 中是否记录了新路径的校验和，而非旧路径。
