第一个 Go 程序与 go 命令详解：module 与工程初识

一、学习目标

二、知识讲解

2.1 Go 程序的基本结构

2.1.1 包与入口函数

是什么：Go 语言以“包”（Package）作为代码组织的基本单位。包是位于同一目录下、共享同一 package 声明的一组源文件，是编译与代码复用的基本单位。每个 Go 文件必须属于且仅属于一个包。 为什么：Go 没有类继承；包通过导入路径组织成层级结构，但包之间没有嵌套声明，语义比命名空间更简单。 怎么用： - package main：声明当前文件属于 main 包。只有 main 包生成的程序是可执行的二进制文件。 - func main()：main 包中必须包含一个无参数、无返回值的 main 函数，它是程序执行的入口点。

2.1.2 import 与包的可见性

是什么：使用 import 关键字引入其他包。 为什么：Go 通过包名隔离命名空间，避免冲突。 怎么用： - 可见性规则：Go 中标识符（变量、函数、类型等）的可见性由首字母大小写决定。首字母大写表示导出（Exported），其他包可以访问；首字母小写表示未导出（Unexported），仅包内可见。 - 导入限制：模块模式下 import 只能是标准库路径或模块路径，不支持 ./sub 这类相对路径。相对导入是 GOPATH 时代的用法，已不再可用。 - 重要约束：package main 不可被其他包导入。如果尝试 import 一个 package main 的包，编译器会报错 is a program, not an importable package。因此，演示“首字母大写=可被访问”时，必须使用非 main 包。

2.2 go 命令详解

Go 工具链提供了丰富的子命令，是日常开发的核心。

2.2.1 go mod init

是什么：初始化当前目录为 Go Module。 为什么：Go 1.16+ 强制要求模块管理。未初始化 Module 时，go get 等命令会直接报错 go.mod file not found...。单文件 go run x.go 仍可运行，但依赖管理与版本记录必须依赖 go.mod。 怎么用：go mod init <module-name>。模块名通常遵循 域名/项目名 的规范。

2.2.2 go run / build / install

• go run：编译并立即运行源文件。适合快速测试代码片段。
• go build：编译源文件。仅当包为 main 时生成可执行文件；编译库包默认只校验是否可编译，不产出文件。
• go install：编译并安装包。可执行文件（main 包）会安装到 GOBIN（默认 GOPATH/bin）并可直接调用；普通库包只被编译检查、不再安装产物文件。模块模式下跨模块安装工具可用 go install example.com/tool@latest。

2.2.3 go vet / fmt / doc / test / mod tidy

• go vet：检查代码中的可疑结构，如 fmt.Printf 参数类型不匹配。这类问题是输出 %!d(...) 之类的错误文本而非 panic，但会掩盖真实结果。
• go fmt：格式化代码，统一风格。
• go doc：查看标准库或本地包的文档。
• go test：运行测试文件（文件名 _test.go）。
• go mod tidy：整理 go.mod 和 go.sum，添加缺失依赖，移除未使用依赖。

三、示例代码

示例 1：Hello World 与模块初始化

本示例演示创建一个标准的 Go 程序结构，并展示 package main 与 func main 的基本用法。

package main

import (
    "fmt"
)

func main() {
    // 打印 Hello World
    fmt.Println("Hello, World!")

    // 演示简单的变量声明与输出
    name := "Go"
    fmt.Printf("Welcome to %s!\n", name)
}

运行结果（预期输出）：

Hello, World!
Welcome to Go!

示例 2：可见性演示与 vet 检查

本示例演示两个文件：一个非 main 包 mypkg 用于展示导出规则，一个 main 包用于调用。同时演示 go vet 对语义错误的检查。

注意：为了在单文件演示中说明可见性，我们在此处仅展示 main 包代码。实际工程中，mypkg 应位于独立目录。此处为了符合“单文件可运行”的约束，我们将 mypkg 的逻辑直接写在 main 包中，但通过注释说明可见性规则。

package main

import (
    "fmt"
)

// ExportedFunc 首字母大写，表示导出（在其他包中可访问）
// 注意：因为本文件属于 package main，而 package main 不可被导入，
// 所以此函数仅在当前包内有效。若移至 mypkg 包，则其他包可调用。
func ExportedFunc() string {
    return "I am exported"
}

// unexportedFunc 首字母小写，表示未导出（仅本包可见）
func unexportedFunc() string {
    return "I am unexported"
}

func main() {
    // 调用导出函数
    fmt.Println(ExportedFunc())

    // 调用未导出函数
    fmt.Println(unexportedFunc())

    // 演示 go vet 检查：格式动词与参数类型不匹配
    // 虽然能编译运行，但 go vet 会警告
    // 这里故意写错以演示 vet 的作用
    var s string = "hello"
    // 下面这行会导致 go vet 警告：format %d has arg s of wrong type string
    // 运行时会输出 %!d(string=hello)
    fmt.Printf("String value: %d\n", s)
}

运行结果（预期输出）：

I am exported
I am unexported
%!d(string=hello)

四、常见错误与避坑指南

五、最佳实践

六、练习题

1. 概念题：解释为什么 package main 中的导出函数不能被其他包导入？
2. 编码题：创建一个名为 calc 的模块，包含一个 Add 函数（首字母大写）和一个 sub 函数（首字母小写）。在 main 包中调用 Add 并打印结果。
3. 进阶/调试题：以下代码存在什么问题？如何修复？ ```go package main

import ( "fmt" )

func main() { var x int = 10 var y string = "hello" fmt.Printf("x: %d, y: %d\n", x, y) } ```

七、练习参考答案

package main

import (
    "fmt"
    "example.com/calc"
)

func main() {
    result := calc.Add(1, 2)
    fmt.Println("Result:", result)
}

package main

import (
    "fmt"
)

func main() {
    var x int = 10
    var y string = "hello"
    // 修复：将 %d 改为 %s
    fmt.Printf("x: %d, y: %s\n", x, y)
}

八、本课小结