go mod init example.com/myproject

myproject/
├── go.mod
├── main.go
└── internal/
    └── utils/
        └── helper.go

package main

import (
    "example.com/myproject/internal/utils"
)

func main() {
    utils.DoSomething()
}
</font>

导入路径由模块名 + 相对目录路径组成，Go 会自动解析。

internal 包的特殊性

Go 对 internal 目录有访问限制：只有其父目录及其子目录下的代码可以引用 internal 中的包。

一个AI驱动的视频开发平台，专为忙碌的企业家和销售团队打造

比如：

• example.com/myproject/cmd/server 可以导入 example.com/myproject/internal/utils
• example.com/otherproject 无法导入该 internal 包

这种机制用于封装不对外暴露的实现细节。

相对路径误区与最佳实践

Go 不支持像 Python 那样的相对导入（如 ./utils）。所有导入必须基于模块路径。

常见错误包括：

• 使用本地路径导入（如 internal/utils 而模块未设置）
• 模块名与实际仓库路径不一致，导致依赖解析失败

建议：

• 保持模块名与项目仓库路径一致（如 GitHub 项目用 github.com/user/repo）
• 子包命名清晰，避免过深嵌套
• 合理使用 internal 保护私有逻辑

基本上就这些。只要模块路径清晰，子包引用就是简单的路径拼接，Go 工具链会自动处理查找和编译。不复杂但容易忽略的是 go.mod 的 module 命名准确性。