Go中包由package声明决定而非目录名，模块路径由go.mod中module定义，import必须使用完整模块路径，go mod tidy用于自动管理依赖。
包（package）是代码组织单位，不是“文件夹别名”
新手常以为“建个目录就自动有了包”，其实包由 package xxx 声明决定，和目录名只是约定关系——不一致就会出问题。比如目录叫 utils，但里面 helper.go 写了 package tools，那 Go 就认为这是个叫 tools 的包，导入时必须用 import "xxx/tools"，而非 "xxx/utils"。
- 每个
.go文件顶部必须有且仅有一个package声明 - 同目录下所有文件的
package名必须完全相同（大小写敏感） -
main包是唯一能编译成可执行文件的包，且必须含func main() - 首字母小写的函数/变量（如
doSomething()）默认不可导出，其他包访问会报错：cannot refer to unexported name xxx.doSomething
模块（module）不是“项目根目录”，而是带 go.mod 的版本化单元
很多新手在任意目录下 go mod init myproj，结果发现 import "myproj/utils" 报错：找不到包。原因很简单——Go 不靠文件系统路径猜模块路径，而严格依赖 go.mod 里声明的 module 名。如果你初始化时写的是 go mod init github.com/you/myproj，那所有本地包的导入路径就必须以 github.com/you/myproj/... 开头。
-
go mod init后生成的go.mod第一行module xxx就是整个模块的“全局身份证”，不能随意改 - 模块路径决定了你本地包的导入路径，例如
module example.com/app→import "example.com/app/utils" - 没
go.mod的目录，Go 默认回退到旧的GOPATH模式，极易引发依赖混乱或no required module provides package错误
导入本地包时，路径不是相对路径，而是模块路径 + 子目录
新手最常犯的错：在 main.go 里写 import "./utils" 或 import "utils"，这在 Go 中完全非法。Go 的 import 路径永远是“完整模块路径”，不是文件系统路径。
myapp/
├── go.mod # module myapp
├── main.go # import "myapp/utils"
└── utils/
└── helper.go # package utils
- 上面结构中，
main.go必须写import "myapp/utils"，哪怕utils/和main.go在同一级目录 - 如果模块名是
github.com/you/myapp，那就得写import "github.com/you/myapp/utils" - 绝对不要用点号、斜杠开头，
import "./utils"、import "../shared"全部编译失败
go mod tidy 不是“装包命令”，而是依赖关系校验器
看到第三方包没下载，新手第一反应是手动 go get，结果可能引入不兼容版本或污染 go.mod。其实 go mod tidy 才是正确起点：它只做两件事——补全当前代码中实际 import 到的依赖，并删掉没被引用的冗余项。
- 先确保代码里已写好
import "github.com/sirupsen/logrus" - 再运行
go mod tidy，它会自动下载、写入go.mod和go.sum - 若报错
require github.com/sirupsen/logrus: version "v1.14.0" invalid，说明你手动改过go.mod，应删掉那行再重试 - 不用
go get也能拉依赖——只要import存在且go mod tidy运行成功
包名是你代码的“作用域边界”，模块名才是 Go 生态里别人找你的“地址”。地址写错，再好的包也收不到调用。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
