Go 中的子目录包不会自动导入：必须显式声明 import

在 Go 语言的实际开发中，有一个经常让人意外的地方——子目录下的包并不会因为和父目录包路径嵌套，就被自动加载。这个问题看似简单，但不少人第一次遇到时都会困惑一阵。咱们先看一个典型的场景：

Go 语言中，子目录下的包（如 pkgfoo/subpkg）与父目录包（如 pkgfoo）完全独立，即使路径存在嵌套关系，也不会因导入父包而自动加载子包；必须单独、显式地 import 才能使用。

没错，这就是 Go 的设计哲学。包是编译和依赖管理的基本单元，而目录结构只是用来组织文件，并不构成逻辑上的层级继承关系。换句话说，github.com/usera/pkgfoo 和 github.com/usera/pkgfoo/subpkg 是两个完全独立的包——它们各自有独立的 package 声明、源文件、符号空间和构建单元。Go 编译器不会因为你导入了父包，就顺手把子目录下的所有包都拉进来。这一点和 Python 的子模块自动发现机制有本质区别。

Go 明确要求：每一个被直接使用的包，都必须出现在 import 列表中。举个例子：

package main

import (
    "log"
    "net/http"
    "github.com/usera/pkgfoo"      // 仅导入 pkgfoo 包
    "github.com/usera/pkgfoo/subpkg" // 必须显式导入 subpkg，否则无法调用其中的函数
)

func main() {
    // ✅ 可以使用 pkgfoo 提供的功能
    pkgfoo.DoSomething()

    // ✅ 可以使用 subpkg 提供的功能（前提是已 import）
    subpkg.ProcessData()

    http.HandleFunc("/login", login)
    if err := http.ListenAndServe(":9090", nil); err != nil {
        log.Fatal("ListenAndServe: ", err)
    }
}

要是漏掉了 import "github.com/usera/pkgfoo/subpkg"，编译时就会报错：

undefined: subpkg

哪怕 subpkg 在文件系统中就躺在 pkgfoo 目录下，Go 也绝不会“猜测”或“推导”依赖关系。这正是 Go 强调 显式优于隐式（Explicit over Implicit）原则的典型体现。

另外，Go 官方文档和 The Go Blog: Package names 里也明确说过，标准库中像 crypto/md5、image/png 这样的路径，仅仅是文件系统组织方式。crypto 包和 crypto/md5 包之间没有代码级关联，也不会相互导入——它们是彼此解耦的独立包。这种设计带来不少好处：可维护性更强，避免了意外依赖，还支持细粒度的模块复用。比如，你可以只用 net/http/httputil 而不必引入整个 net/http。

说到这里，给出几条实用的建议：

• 每个实际用到的包，都在 import 块中单独列出；
• 千万别因为省事而导入父目录，然后指望它自动覆盖子包——这个假设是错的；
• 用 go list -f '{{.Imports}}' ./... 这类工具辅助检查真实的依赖关系；
• 在模块化设计里，合理利用子目录来表达逻辑分组（比如 storage、storage/sql、storage/memory），但始终以 import 语句为准绳。

总结一下：Go 没有“子包”这个概念，只有“路径前缀相同但彼此独立的包”。是否导入，由你决定；是否可用，由 import 决定。