一、Go Module 概述

Go Module 是 Go 1.11 版本（2018 年 8 月）引入的依赖管理系统，用于替代传统的 GOPATH 模式。其核心目标是解决 GOPATH 模式下的依赖版本控制问题和工作目录污染问题，使项目可以在任意路径下独立管理依赖，无需强制遵循 GOPATH 结构。

适用版本

• Go 1.11~1.13：需通过环境变量GO111MODULE手动开启（默认值为auto）。
• Go 1.14+：默认启用 Go Module，逐步淘汰对 GOPATH 模式的依赖。
• Go 1.16+：推荐在生产环境中使用。

二、Go Module 核心特性

1. 项目结构

• 核心文件：每个 Go Module 项目的根目录必须包含一个go.mod文件，用于描述模块名称、Go 版本和依赖关系。

  module gitee.com/infraboard/go-course// 模块名称（唯一标识）go1.16// 项目使用的 Go 版本

• 依赖存储：依赖包默认下载到$GOPATH/pkg/mod目录，而非直接存放在项目路径中，避免污染工作目录。

2. 依赖查找机制

开启 Go Module 后，编译器按以下顺序搜索依赖包：

1. 当前项目路径：模块名称打头的包（如gitee.com/infraboard/go-course/day1/compile/pkg）。
2. 缓存目录：$GOPATH/pkg/mod下的预编译依赖包。
3. Go 安装目录：$GOROOT/src下的标准库包。

对比 GOPATH 模式：Go Module 完全忽略 GOPATH 中的src目录（除标准库外），仅通过go.mod管理依赖，解决了多项目依赖冲突问题。

三、如何启用 Go Module

Go Module 的开关由环境变量GO111MODULE控制（Go 1.16+ 版本默认值为on，无需手动设置）：

# 查看当前值goenvGO111MODULE# 手动设置（Go 1.11~1.15 需注意）：# on：强制启用 Go Module（推荐新项目使用）# off：强制禁用，使用传统 GOPATH 模式（兼容旧项目）# auto：自动判断（项目含 go.mod 则启用，否则使用 GOPATH）goenv-wGO111MODULE=on

四、创建 Go Module 项目

步骤 1：新建项目目录（非 GOPATH 路径）

mkdirmy-go-module-projectcdmy-go-module-project

步骤 2：初始化 Go Module

# 使用模块名称初始化（模块名称通常为项目的代码仓库地址）go mod init example.com/my-project

执行后会生成go.mod文件，内容类似：

module example.com/my-projectgo1.16

步骤 3：编写代码并管理依赖

• 在项目中直接编写代码，无需将文件放入src目录。
• 通过go get命令添加依赖，依赖会自动写入go.mod和go.sum（记录依赖哈希值，确保一致性）。

  go get github.com/jinzhu/gorm@v1.20.1# 指定版本获取依赖

五、Go Module 关键命令

1. 版本控制：通过go.mod和go.sum精确管理依赖版本，避免版本混乱。
2. 独立项目：项目可在任意路径下创建，无需受限于 GOPATH 结构。
3. 依赖隔离：依赖存储在统一缓存目录（$GOPATH/pkg/mod），避免项目间依赖污染。
4. 兼容性：通过GO111MODULE=auto无缝兼容旧版 GOPATH 项目。