Go 语言中，import 语句指定的是包的导入路径（对应文件系统目录），而代码中调用时使用的 PackageName.Identifier 中的 PackageName 是 .go 文件顶部 package 声明的标识符——二者逻辑解耦，这是 Go 包模型的核心设计，也是区别于 Java/Python 的关键。
go 语言中，import 语句指定的是**包的导入路径（对应文件系统目录）**，而代码中调用时使用的 `packagename.identifier` 中的 `packagename` 是 `.go` 文件顶部 `package` 声明的标识符——二者逻辑解耦，这是 go 包模型的核心设计，也是区别于 java/python 的关键。
在 Go 中，“包”（package）是一个编译单元概念，由所有同名 package 声明且位于同一目录下的 .go 文件共同组成。这里有两个相互独立但协同工作的关键要素：
✅ 1. package 声明名：决定作用域内引用方式
每个 .go 文件首行必须是 package <name></name>，其中 <name></name> 是一个合法的 Go 标识符（如 foopkg、main、http），它定义了该包对外暴露的命名空间前缀。例如：
// 1-foodir/2-foofile.go
package foopkg // ← 编译后，所有导出符号（如 FooFunc）都属于 foopkg 这个包名
func FooFunc() string { return "FooFunc" }因此，在 demo.go 中必须写 foopkg.FooFunc() —— 这里的 foopkg 不是目录名，而是 Go 编译器从源码中解析出的包标识符，用于类型检查、作用域解析和符号链接。
✅ 2. 导入路径（import path）：决定如何定位和加载包
import "1-foodir" 中的 "1-foodir" 是导入路径（import path），它本质上是相对于 $GOPATH/src（或 module root）的文件系统相对路径，用于定位包含该包源码的目录。Go 通过此路径找到目录下所有 package foopkg 的文件，然后按包名（而非路径名）进行聚合编译。
? 关键规则：
- 同一目录下所有
.go文件的package声明必须完全一致，否则编译报错：found packages foopkg (2-foofile.go) and main (other.go)- 不同目录可拥有相同
package名（如package utils），只要导入路径不同，即视为不同包；- 导入路径可任意命名（含
-、数字等），只要符合文件系统可寻址性，但package名必须是合法标识符（不能含-或数字开头）。
✅ 3. 实际开发中的典型模式与最佳实践
虽然技术上允许 import "github.com/user/repo/v2/internal/log" 而包声明为 package logger，但为提升可读性与维护性，Go 社区强烈推荐 “目录名 ≈ 包名” 的约定（如 net/http 目录下 package http）。标准库与主流项目均遵循此惯例。
不过，第三方模块常打破该约定：
import (
yaml "gopkg.in/yaml.v3" // 导入路径含版本号，包名却是合法标识符 'yaml'
)
// 使用时：yaml.Marshal(...)你甚至可以显式重命名导入包：
import (
myfoo "1-foodir" // 将导入路径 "1-foodir" 绑定到本地别名 myfoo
)
// 调用变为：myfoo.FooFunc() —— 此时 myfoo 是别名，实际仍依赖 2-foofile.go 中的 package foopkg⚠️ 注意事项总结
- ❌ 不要误以为
import "a/b"意味着包名是b；它只是路径，包名由b/x.go中的package xxx决定； - ❌ 不可在同一目录混用多个
package名，否则构建失败； - ✅ 利用导入别名解决命名冲突（如同时引入两个
package log）； - ✅ 在模块化（Go Modules）时代，导入路径通常以
module-path/subdir形式出现，更凸显路径与包名的分离设计。
这种设计使 Go 能灵活支持版本管理（如 /v2 路径）、内部包隔离（/internal/）、多包共存等场景，是其工程化能力的重要基石。理解这一分离，是写出清晰、可维护 Go 代码的第一步。
