模块路径变更后需同步更新go.mod的module声明和所有.go文件中的import路径，否则go mod tidy因路径不匹配报错；replace仅作临时重定向，最终须彻底切换import路径。
模块路径变更后 go mod tidy 报错找不到包
模块路径改了（比如从 github.com/oldorg/project 换成 github.com/neworg/project），但旧导入路径仍残留在代码里，go mod tidy 会报类似 cannot find module providing package github.com/oldorg/project/pkg 的错误。
根本原因不是“没下载”，而是 Go 模块系统严格按 go.mod 中的 module 声明和源码中的 import 路径做匹配——二者必须一致，否则视为缺失依赖。
- 先确认当前
go.mod文件顶部的module行已更新为新路径 - 用
grep -r "github.com/oldorg/project" . --include="*.go"扫描所有.go文件，手动替换全部import语句 - 不要只改包名（如
import foo "github.com/oldorg/project/pkg"→import foo "github.com/neworg/project/pkg"），要同步改模块路径本身 - 替换后运行
go mod tidy，它会自动清理旧 require 并添加新路径的版本记录
想保留旧包名但用新路径：用 replace 临时重定向
迁移过程中，可能希望本地开发时继续用旧路径写代码，但实际加载新仓库的代码。这时不能靠 import 别名，得靠 go.mod 的 replace 指令。
replace 是模块级重写，影响整个构建过程，对 CI 或他人 clone 后直接 go build 也生效（只要 go.mod 提交了）。
立即学习“go语言免费学习笔记（深入）”；
- 在
go.mod末尾添加：replace github.com/oldorg/project => github.com/neworg/project v1.2.3
- 注意右边必须是有效的模块路径 + 版本号（可为
latest，但不推荐；建议用具体 tag 或 commit hash） - 如果新路径还没打 tag，可用本地路径：
replace github.com/oldorg/project => ../new-project
（相对路径需存在且含有效go.mod） -
replace不解决跨团队协作的长期可维护性问题，只是过渡手段，上线前应彻底切换 import 路径
导入时用点号或下划线别名？这些写法的实际含义
Go 中 import 后跟的标识符不是“包名重命名”，而是导入声明符（import identifier），控制该包内符号在当前文件中的引用方式。
-
import "github.com/neworg/project/pkg"：默认使用pkg作为包名，调用pkg.DoSomething() -
import mypkg "github.com/neworg/project/pkg"：用mypkg替代默认包名，调用mypkg.DoSomething()（避免冲突或缩短长名） -
import _ "github.com/neworg/project/pkg"：仅执行该包的init()函数，不引入任何导出符号（常见于驱动注册，如_ "github.com/lib/pq"） -
import . "github.com/neworg/project/pkg"：将该包所有导出名“扁平”引入当前作用域（DoSomething()可直接调，无需前缀）——极不推荐，破坏命名空间隔离，容易冲突且难以追踪来源
重命名包名不会改变模块路径，也不会触发 go get 行为
很多人误以为 import foo "github.com/neworg/project/pkg" 会让 Go 去拉取 foo 这个包。其实完全不会——Go 只认引号里的完整路径，foo 纯属本地变量名，和网络、模块无关。
这也意味着：同一模块路径可以被多个不同别名导入，甚至在同一文件中：
import (
v1 "github.com/neworg/project/api/v1"
v2 "github.com/neworg/project/api/v2"
)
// 使用时明确区分：v1.GetUser(), v2.GetUser()
这种写法在处理多版本 API、避免循环依赖或测试 mock 时很实用。但要注意：别名只在当前文件生效，不影响其他包对该模块的引用方式。
真正容易被忽略的是 replace 和 import 别名的混淆——前者改的是模块解析逻辑，后者只是语法糖。改路径不改 go.mod 的 replace 或没清掉旧 import，再怎么换别名都救不了编译失败。
