golang 1.24全部内置包、常用第三方库、包管理

数据操作相关

IO、编码相关

控制、调试相关

第三方库

包管理

创建项目

> go mod init awesomeProject

会自动创建 go.mod 文件

module awesomeProject

go 1.24.3

创建代码文件 main.go

package main

import (
	"github.com/gin-gonic/gin"
	"net/http"
)

func main() {
	// 创建默认的 gin 引擎
	r := gin.Default()

	// 定义一个简单的路由
	r.GET("/", func(c *gin.Context) {
		c.JSON(http.StatusOK, gin.H{
			"message": "Hello, Gin!",
		})
	})

	// 启动服务器
	err := r.Run(":8080")
	if err != nil {
		return
	}
}

构建并运行

> go mod tidy

更新 go.mod 依赖项，会根据代码中的 import 下载并引入依赖包，并移除不需要的包

go.mod 示例

module awesomeProject2

go 1.24.3

require github.com/gin-gonic/gin v1.10.1

require (
	github.com/bytedance/sonic v1.13.3 // indirect
	github.com/bytedance/sonic/loader v0.2.4 // indirect
)

> go build

构建，生成可执行文件

vendor

> go mod vendor

将第三方依赖包存入工程中的vendor目录，go build会优先从vendor中查找依赖项。更新vendor目录需要重复执行指令。

依赖包版本

版本格式为 v(major).(minor).(patch)，比如 v1.2.3。
一般认为，major版本更新不向后兼容，minor版本更新向后兼容，而 import 会区分major版本，比如

import "github.com/pelletier/go-toml/v2"

即一个项目可以同时使用一个依赖包的两个版本。

go mod tidy 版本选择：

• 直接依赖包，即代码中 import 的包，会选择该major版本的最新小版本
• 间接依赖包，即 import 的包依赖的其他包，会选择最高的显式依赖版本，比如，B依赖D的 1.0.0，C依赖D的1.2.3，则D选择1.2.3

更新版本：

> go get -u

更新minor版本，比如 v1.2.3 更新到 v1.3.1

> go get -u=patch

只更新patch版本，比如 v1.2.3 更新到 v1.2.5

查看可更新列表：

> go list -u -m all

replace：
替换依赖库，比如原库不存在，或者修复原库的bug，可在 go.mod 中使用 replace 替换

replace example.com/theirmodule v1.2.3 => example.com/myfork/theirmodule v1.2.3-fixed

exclude：
排除依赖库，可用于排除间接依赖但实际不会被加载的包

exclude example.com/theirmodule v1.3.0