Go的package是编译与可见性的硬性边界,强制“一个目录=一个包”,导出由首字母大小写决定,import路径是模块内相对路径而非包名别名。

Go语言的package不是“模块”的别名,而是编译与可见性的硬性边界——它直接决定哪些代码能被其他文件调用、哪些会被编译器拒绝。
为什么必须每个目录一个 package?
Go 强制“一个目录 = 一个包”,这是编译器解析依赖的基石。它不靠文件名或路径推断,而是靠目录结构做静态分析:当你写 import "./utils",Go 就去当前目录下找 utils/ 这个文件夹,并检查里面所有 .go 文件是否都声明了 package utils。一旦某文件写了 package other,整个目录就编译失败。
- 好处是项目结构一目了然,
cmd/、internal/、pkg/这类目录名本身就表达了用途 - 坏处是不能像 Python 那样把多个逻辑相关的
.py散在同层——你得手动建目录,哪怕只放一个文件 - 常见错误:
cannot load ./xxx: package xxx is not in GOROOT,往往是因为目录名和package声明不一致,或没启用 Go Modules
导出规则:大写字母不是风格,是语法
Go 没有 public、private 关键字,导出与否完全由首字母大小写决定。这不是约定,是编译器强制执行的可见性开关。
-
func DoSomething()→ 可被其他包调用,如utils.DoSomething() -
func doSomething()→ 编译期就屏蔽,连 IDE 都不会提示,外部调用直接报错undefined: utils.doSomething - 结构体字段也一样:
Name string可导出,name string在 JSON 序列化、反射、跨包访问时全不可见 - 注意:包名本身小写(如
package httputil),但导出标识符必须大写——包名和导出名大小写规则互不干扰
import 路径不是包名,而是模块内相对路径
你在 import 里写的字符串,是 Go 工具链用来定位目录的路径,不是运行时的命名空间别名。
立即学习“go语言免费学习笔记(深入)”;
- 启用 Go Modules 后,路径基于
go.mod中的模块名,比如模块是github.com/user/proj,那import "github.com/user/proj/utils"才合法 - 本地测试时用
import "./utils"是临时方案,仅限未初始化模块或快速验证;上线项目必须用模块路径,否则 CI 或他人 clone 后无法构建 - 别名导入如
import jsoniter "github.com/json-iterator/go"只改变当前文件的引用前缀,不影响包内导出逻辑 - 匿名导入(
import _ "net/http/pprof")本质是触发该包的init()函数,不引入任何符号——常用于注册 HTTP handler 或数据库驱动
最易被忽略的一点:同一个包内的多个文件,即使分散在不同 .go 文件中,也共享同一命名空间,且无需 import —— 这意味着你可以把接口定义放在 interface.go,实现放在 impl.go,它们天然互通。但这恰恰也是新手误以为“不 import 就能跨包调用”的源头:跨包永远要 import,且首字母必须大写,少一个条件就编译不过。










