go禁止使用"./"或"../"开头的本地导入路径，因其违反逻辑路径设计原则；必须使用以go.mod中module声明开头的完整路径，如"github.com/yourname/myapp/internal/service"。
为什么 import "./xxx" 会报错 can't load package: local import
Go 编译器从 1.0 版本起就禁止以 ./ 或 ../ 开头的导入路径，这不是环境配置问题，而是语言设计硬约束。错误信息 can't load package: local import "../package" in non-local package 就是明确拒绝——go build、go test、go install 全部不认这种写法。
根本原因在于：Go 的 import 声明的是逻辑路径（import path），不是文件系统路径。它必须能被全局解析、跨机器复现、支持 go get 拉取。相对路径天然不具备这些特性。
- 仅
go run main.go可能“看似”成功，是因为它在单文件模式下临时推导，但无法生成可安装的二进制，也不参与模块依赖分析 - 即使项目结构完全正确，只要 import 行写了
"./handler"，go mod tidy就会静默跳过该行，后续构建必然失败 - IDE（如 VS Code + gopls）可能因缓存误报“未使用”，实则是路径根本没被 Go 工具链识别
Go Modules 下 import 路径必须与 module 声明严格一致
启用 Go Modules 后，所有本地包导入路径都必须以 go.mod 中的 module 指令开头。比如 go.mod 写着：
module github.com/yourname/myapp
那么目录 myapp/internal/service 的包，就必须用 "github.com/yourname/myapp/internal/service" 导入，而不是 "internal/service" 或 "myapp/internal/service"。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 路径大小写敏感：若目录名是
Service，但 import 写成"github.com/yourname/myapp/service"，编译直接报cannot find package - 子模块无需额外
go mod init：只要在同一个根模块下，github.com/yourname/myapp/utils和github.com/yourname/myapp/api都自动属于该模块，无需各自建go.mod -
replace不改变 import 路径：即使你用replace github.com/yourname/myapp => ./local指向本地目录，import 语句仍必须写完整远程路径，否则工具链找不到目标
项目重命名时，三处 import 路径必须同步更新
把项目从 github.com/oldname/app 改成 github.com/newname/app，只改目录名或只改 go.mod 中的 module 行是不够的。
- 第一处：
go.mod文件首行module github.com/newname/app - 第二处：所有
.go文件中的import语句，包括自己引用自己的路径（如"github.com/oldname/app/utils"→"github.com/newname/app/utils"） - 第三处：若有其他项目依赖你，它们的
go.mod中require行也得改，且需运行go mod tidy重新解析
漏掉任意一处，go build 会提示 import "github.com/oldname/app/utils": cannot find module providing package，而错误位置往往指向调用方而非定义方，排查成本陡增。
不要省略域名前缀，哪怕只是本地开发
写 module myapp 或 module local/myapp 是常见误区。虽然 go mod init 允许这样执行，但会导致：
-
go get无法拉取：没有域名，Go 认为这是标准库或内置包，去$GOROOT/src或$GOPATH/src查找，必然失败 - 团队协作断裂：别人 clone 你的 repo 后，
go mod download会尝试解析myapp为远程 URL，最终 fallback 到空依赖或报错 - CI/CD 构建失败：多数 CI 环境禁用 GOPATH 模式，且默认关闭
GO111MODULE=auto，此时无域名的 module 路径直接不可构建
正确做法是用真实可注册的域名前缀，如 github.com/yourname/myapp、gitlab.com/team/proj，哪怕代码尚未 push 到远端——路径本身是逻辑标识，不依赖网络可达性。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
