Go中包由package声明与目录路径共同定义,每个目录对应一个包且所有.go文件须声明相同包名;主程序包名为main,库包名小写简洁;首字母大写的标识符才对外公开;import路径映射文件系统路径,go mod用于模块管理。

在 Go 语言中,包(package)是代码组织和模块化管理的核心机制。它不是靠目录结构“自动”形成模块,而是由 package 声明 + 目录路径共同定义的——每个目录对应一个包,且该目录下所有 .go 文件必须声明相同的包名。
包的基本规则与命名规范
Go 要求每个源文件开头必须有 package xxx 声明。常见约定包括:
- 可执行程序的主入口包名必须是
main,且需包含func main() - 库包名应为小写、简洁、语义明确(如
http、json),避免下划线或驼峰 - 包名通常与所在目录名一致(非强制但强烈推荐),便于 import 路径推导
- 首字母大写的标识符(函数、类型、变量等)才对外公开;小写则仅在包内可见
目录结构决定 import 路径
Go 没有传统意义上的“模块路径配置”,import 路径直接映射到文件系统路径(从 $GOPATH/src 或 module root 开始)。例如:
若项目根目录是 myapp,其中 myapp/utils/stringutil.go 内声明 package stringutil,那么其他地方应这样导入:
立即学习“go语言免费学习笔记(深入)”;
import "myapp/utils/stringutil"
注意:import 路径不是包名,而是从模块根开始的相对路径;包名只是该路径下所有文件共用的逻辑命名空间。
云模块_YunMOK网站管理系统采用PHP+MYSQL为编程语言,搭载自主研发的模块化引擎驱动技术,实现可视化拖拽无技术创建并管理网站!如你所想,无限可能,支持创建任何网站:企业、商城、O2O、门户、论坛、人才等一块儿搞定!永久免费授权,包括商业用途; 默认内置三套免费模板。PC网站+手机网站+适配微信+文章管理+产品管理+SEO优化+组件扩展+NEW Login界面.....目测已经遥遥领先..
使用 go mod 管理依赖与模块边界
从 Go 1.11 起,官方推荐用 go mod 实现模块化管理。初始化模块只需在项目根目录运行:
go mod init myapp
此后,go build、go run 等命令会自动识别模块路径,并记录依赖到 go.mod 文件中。关键点:
- 一个模块(module)可包含多个包,每个子目录是一个独立包
-
go.mod中的module行定义了该模块的根路径,也是所有内部包 import 路径的起点 - 第三方依赖通过
go get自动下载并写入go.mod,版本信息受控
跨包调用与可见性控制
包之间通过 import 关联,调用时使用 包名.标识符 形式。例如:
// utils/mathutil.go
package mathutil
func Add(a, b int) int { return a + b }
func multiply(a, b int) int { return a * b } // 小写,不可导出
在 main.go 中使用:
package main
import (
"fmt"
"myapp/utils/mathutil"
)
func main() {
fmt.Println(mathutil.Add(2, 3)) // ✅ 可调用
// fmt.Println(mathutil.multiply(2, 3)) // ❌ 编译错误:未导出
}
可见性由首字母大小写决定,这是 Go 实现封装的唯一方式,无需 public/private 关键字。









