go.mod是Go模块的核心配置文件，定义模块名、Go版本及依赖。module声明模块路径，作为导入包的前缀；go指定Go语言版本，影响语法特性和模块行为；require列出直接依赖及其版本，支持// indirect标记间接依赖；replace可替换依赖源，常用于本地调试；exclude用于排除特定有问题的版本。文件由go mod命令管理，通过go get添加依赖，go mod tidy清理冗余，自动维护依赖一致性，帮助解决版本冲突。
go.mod 文件是 Go 语言从 1.11 版本引入的模块管理文件，用来定义一个 Go 模块的基本信息和依赖关系。它位于项目根目录下，作用类似于 node.js 的 package.json 或 python 的 requirements.txt。
module：声明模块名称
第一行通常以 module 开头，表示当前项目的模块路径：
module example.com/myproject
这个路径不一定是真实网址，但建议使用唯一的域名前缀来避免命名冲突。它用于：
- 作为导入包的路径前缀（如 import “example.com/myproject/utils”）
- 在构建、测试、发布时标识模块身份
go：指定 Go 版本
用 go 关键字声明项目使用的 Go 语言版本：
立即学习“go语言免费学习笔记（深入）”；
go 1.20
这会影响编译器对语法特性和模块行为的处理方式。例如，Go 1.18 引入了泛型，如果写 go 1.17，则即使你用的是 1.20 编译器，某些新特性也不会启用。
require：声明依赖项
列出项目直接依赖的外部模块及其版本：
require ( github.com/gin-gonic/gin v1.9.1 golang.org/x/text v0.12.0 )
每行包含模块路径和版本号。版本号格式通常是 vX.Y.Z（遵循语义化版本）。Go 工具链会根据这些信息下载对应依赖并记录到 go.sum 中。
有些 require 行后面可能带注释 // indirect，表示这个依赖不是你直接 import 的，而是某个你依赖的库需要它。
replace：替换依赖（可选）
用于本地调试或临时替换某个依赖源，比如把远程库换成本地路径：
replace golang.org/x/net => ./forks/net
这样在构建时就会使用本地的 net 模块而不是从网络下载。上线前应移除这类替换，避免影响他人构建。
exclude：排除特定版本（较少用）
可以排除某个有问题的版本，防止被自动选中：
exclude golang.org/x/crypto v0.5.0
一般不推荐频繁使用，除非遇到已知崩溃或安全问题的版本。
基本上就这些。go.mod 文件由 go mod 命令自动生成和维护，日常开发中你主要通过 go get 添加/升级依赖，go mod tidy 清理无用依赖，不需要手动改太多内容。理解它的结构有助于排查依赖冲突或版本问题。