Go强制要求package名与目录名完全一致，否则编译报错“package xxx not in directory yyy”；首字母大小写决定标识符是否可导出，小写即不可跨包访问。
Go 中 package 名和文件夹名不一致会怎样
编译直接报错，package "xxx" not in directory "yyy"。Go 强制要求 package 声明（如 package main）必须与所在目录名完全一致（大小写敏感），不是“建议”，是硬性约束。
常见错误现象：把 utils/ 目录下的文件写成 package helper；或者用 IDE 重命名文件夹但忘了改 package 声明。
- 目录名决定该包在 import path 中的末段（比如
github.com/u/p/utils的utils来自目录名） -
package main是特例，只用于可执行程序，且必须放在main目录下（或根目录） - 测试文件（
*_test.go）可以声明同名package，但必须和被测代码在同一目录、同一package下（除非是外部测试）
import 路径里写相对路径为什么总失败
Go 不支持相对路径导入，import "./utils" 或 import "../config" 全部非法。所有 import 必须是完整模块路径（如 github.com/user/project/utils）或标准库名（如 "fmt"）。
根本原因：Go 编译器靠 import path 定位包，而路径解析依赖 GO111MODULE 和 go.mod 里的 module 声明，不是文件系统相对位置。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 本地开发时，用
go mod edit -replace=old/path=../local/path替换依赖，而不是改 import 字符串 - 刚初始化项目就遇到 “cannot find module”？先运行
go mod init example.com/foo，确保go.mod存在且module声明合理 - IDE 显示导入红色波浪线但
go build正常？大概率是 IDE 缓存了旧的 module root，重启 Go plugin 或删掉.idea/go.work
首字母大小写如何实际影响变量/函数能否被其他包访问
可见性只看标识符首字母：大写（Exported）对外公开，小写（unexported）仅限本包内使用。这不是约定，是编译器强制规则，连反射都绕不过。
典型误判：以为加了 public 注释或导出 struct 就能跨包调用字段——没用。字段本身首字母小写，哪怕 struct 是大写的，字段依然不可见。
-
type Config struct { Port int `json:"port"` }→Port可导出，port不可导出 -
func Do() {}可被导入；func do() {}只能在当前package内调用 - 嵌套结构体字段是否可导出，和外层 struct 名字无关，只看字段名首字母
- 小写名字的函数/变量，在其他包里连
pkg.name这种写法都会触发编译错误：cannot refer to unexported name pkg.name
多个文件同属一个 package 却出现 “duplicate symbol” 或 “undefined”
不是链接错误，是 Go 的包模型误解导致的：同一个 package 下所有文件共享作用域，但必须满足两个前提——都在同一目录、且没有重复的 func main() 或同名全局变量定义。
常见于复制粘贴代码后忘记删掉另一个 main.go，或在非 main 包里误写多个 func main()。
- 同一
package下允许有多个文件，无需显式声明“属于谁”，只要目录和package声明一致即可 - 禁止在非
main包中定义func main()，否则go build会报cannot use func main as value - 全局变量同名（如两个
var Version = "1.0"）会触发redefinition错误，即使在不同文件里 - 测试文件（
*_test.go）若声明了和源文件相同的package，它们就属于同一个包，变量/函数可直接互访——这是有意设计，不是 bug
