07.包管理和模块

包和模块是 Go 语言中管理和维护大型代码库的基础设施。
它们帮助你组织代码，确保代码的可重用性和易维护性。🦌📚

包

在 Go 中，包用于组织和重用代码。
一个包就是一个包含 Go 源代码文件的目录。
每个文件都以 package <name> 声明开头，这表明该文件属于哪个包。

创建自己的包时，可以将相关的功能组织在一起，例如：

// 文件名: mathops/add.go
package mathops

// Add 返回两个整数的和
func Add(a, b int) int {
    return a + b
}

// 文件名: mathops/subtract.go
package mathops

// Subtract 返回两个整数的差
func Subtract(a, b int) int {
    return a - b
}

模块

Go 模块是 Go 1.11 中引入的，用于版本控制和包共享。
模块是一系列包的集合，它定义了包的依赖关系。
创建一个新模块很简单，可以使用 go mod init 命令。

当你创建一个新项目时，首先在项目根目录运行 go mod init <module-name>，这将创建一个 go.mod 文件，该文件跟踪项目的依赖关系。

go mod init example.com/mymodule

这将创建一个新的 go.mod 文件，里面包含了模块的名字和当前的 Go 版本。

看起来像这样：

module github.com/myusername/mymodule

go 1.16

添加依赖

当你导入其他包并使用它们时，Go 会自动将这些依赖项添加到你的 go.mod 文件中。

import "github.com/someone/dependency"

func useDependency() {
    dependency.DoSomething()
}

第一次运行 go build 或 go test 时，Go 会自动下载并记录依赖项的正确版本。

版本控制

go.mod 文件还会记录每个依赖项的版本，确保每次构建项目时都能获得相同版本的依赖，这样就可以避免意外的更新导致的问题。

module example.com/mymodule

go 1.16

require github.com/someone/dependency v1.2.3

上面的 go.mod 文件表明，我们的模块依赖于 github.com/someone/dependency 的 v1.2.3 版本。

管理依赖

你可以使用 go get 命令来更新依赖项到特定版本。

go get github.com/someone/[email protected]

以上命令会将 dependency 包更新到 v1.3.0 版本，并且更新 go.mod 文件。

通过使用包和模块，Go 语言提供了一种清晰的方式来组织和管理代码。
这样，无论是在小型还是大型项目中，代码都能保持清晰和易于管理。

结合使用包和模块

在实际的 Go 项目中，包和模块一起工作，确保你可以构建和维护大型项目。
包提供了代码的逻辑组织，而模块则处理版本控制和依赖管理。

在实践中，你可能会有一个项目结构，类似于这样：

/myapp
    /cmd
        main.go
    /pkg
        /mathops
            add.go
            subtract.go
    go.mod

在 /cmd 目录中的 main.go 文件里，你可以导入 mathops 包，并使用它的函数：

package main

import (
    "fmt"
    "myapp/pkg/mathops"
)

func main() {
    fmt.Println(mathops.Add(1, 2))
    fmt.Println(mathops.Subtract(5, 3))
}

记住，Go 的美在于其简洁性。包和模块让代码结构清晰，并且易于管理。