根本原因是import路径未对齐go.mod中module声明；Go只认模块路径而非文件路径，如module myapp则必须用"myapp/utils"导入，"./utils"或"utils"均非法。
go mod init 后 import 本地包仍报错
根本原因不是路径写错了，而是 import 路径没对齐 go.mod 第一行的 module 声明。Go 不认文件系统路径，只认模块路径。
- 执行
go mod init myapp后，myapp/utils才是合法 import 路径，"./utils"或"utils"都会触发no required module provides package -
utils/helper.go里package utils没问题，但 import 时必须用"myapp/utils"—— 包名和 import 路径无关，但引用时用的是包名（比如调用utils.Do()） - 别手动改
go.mod里的module名去“凑” import；应该让所有 import 都以module值为前缀 - 确保
main.go和go.mod在同一目录，否则go build会找不到模块根
多个 go.mod 共存时主模块无法加载子模块
Go 默认只识别向上最近的 go.mod，不会自动发现同级或子目录下的其他模块。直接 import "github.com/yourorg/lib" 会报 module is not a dependency of module。
- 在主模块的
go.mod中加replace github.com/yourorg/lib => ./lib，其中./lib必须是含独立go.mod的目录（且其module声明必须是github.com/yourorg/lib） - 执行
go mod tidy后，运行go list -m all应看到github.com/yourorg/lib => ./lib，表示生效 -
replace是开发期临时方案，CI 构建前必须删掉，否则远程构建失败；建议 CI 加GOFLAGS="-mod=readonly"提前拦截 - 子模块路径必须是相对于主模块
go.mod的有效路径，不能用../lib（除非主模块不在顶层）
跨模块 import cycle not allowed
这不是模块配置问题，是代码结构缺陷：A 模块 import B，B 又间接 import A。模块边界不解决循环依赖，只会让错误更早暴露。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 用
go mod graph | grep your-module或go list -f '{{.Deps}}' your/pkg查实际依赖链 - 常见诱因是共享类型/常量/错误定义被塞进互相依赖的包里；应抽离到独立公共模块（如
github.com/yourorg/shared），并在 A、B 中都replace它 - 别把共享代码放
internal/下——internal对跨模块完全不可见，强行 import 会报use of internal package not allowed - 接口解耦可缓解，但不能替代结构重构；循环一旦形成，迟早要拆
VS Code / GoLand 提示找不到包但命令行能编译
IDE 的 gopls 没识别出当前工作区的模块根，它不知道该从哪开始解析 import 路径。
立即学习“go语言免费学习笔记（深入）”；
- 必须用含
go.mod的目录作为 VS Code 工作区根目录打开项目，不是父目录，也不是子目录 - 按
Ctrl+Shift+P→ 输入Go: Restart Language Server强制刷新缓存 - 检查设置中
go.gopath是否被手动填了值——现代项目应留空，让gopls自动推导 - 如果项目有多个
go.mod（比如 monorepo），确认你编辑的文件属于哪个模块；在错误模块上下文中编辑，gopls就会按错的go.mod解析 import
replace 的生命周期、IDE 工作区根、循环依赖的物理拆分——这四点任何一个没对齐，都会导致看似“随机”的导入失败。最容易被忽略的是：命令行能跑 ≠ IDE 能识别，而后者往往掩盖了路径不一致的真实问题。 
