Go 语言代码结构

概述

本文介绍 Go 程序的最基本组成：包声明、导入、main 函数和注释，并通过 Hello World 示例带你跑通第一个 Go 程序。

正文

一个 Go 程序由什么构成？

在深入语法细节之前，先思考一个问题："如果让你写一个能打印 'Hello, World!' 的 Go 程序，你知道它最少需要几行代码？"

答案是 5 行（不算空行和注释）。下面这个最小可运行的 Go 程序展示了所有核心要素：

package main              // 1. 包声明

import "fmt"              // 2. 导入包

func main() {             // 3. main 函数（程序入口）
    fmt.Println("Hello, World!")  // 4. 调用函数 + 自动换行
}

[!question] ❓ 思考

package main 为什么必须是第一行非注释代码？

如果去掉 import "fmt"，程序还能编译通过吗？

main() 函数可以带参数吗？如果不写 () 会怎样？

每一行的作用如下：

要素	说明
`package main`	声明包名。`main` 包表示这是一个可执行程序（而非库）
`import "fmt"`	导入标准库 `fmt`，提供格式化输入输出功能
`func main()`	程序的唯一入口。可执行程序的 `main` 包必须有且仅有一个 `main` 函数
`/* ... */` / `//`	多行注释 / 单行注释，编译时被忽略
`fmt.Println(...)`	将内容输出到控制台，末尾自动添加 `\n`

[!tip] 💡 Print vs Println fmt.Print 不会自动换行，fmt.Println 会在末尾追加 \n。两者都支持变量插值：fmt.Println(arr, name, age) 会用默认格式打印所有参数。

运行你的第一个程序

保存为 hello.go 后，在终端执行：

$ go run hello.go
Hello, World!

go run 会编译并立即执行。如果想单独生成二进制文件，用 go build：

$ go build hello.go   # 生成 ./hello 二进制文件
$ ./hello              # 运行
Hello, World!

[!note] 📝 go run vs go build go run 适合快速调试；go build 生成独立二进制文件，方便部署和分发。

包与文件的关系

这是新手最容易困惑的地方。记住三条规则：

[!warning] ⚠️ 常见误区

文件名 ≠ 包名：helloworld.go 可以是 package main

文件夹名 ≠ 包名：目录叫 myMath，包名可以是 mathclass

同目录 = 同包：同一个文件夹下的 .go 文件必须属于同一个包，否则编译报错

graph LR
    A["项目根目录"] --> B["hello/"]
    B --> B1["helloworld.go → package main"]
    A --> C["mymath/"]
    C --> C1["myMath1.go → package mathClass"]
    C --> C2["myMath2.go → package mathClass"]

关键点：myMath1.go 和 myMath2.go 虽然在不同文件中，但包名都是 mathClass，它们共享这个包的命名空间。

导出与未导出标识符

Go 没有 public / private 关键字，而是用大小写控制可见性：

[!note] 📝 导出规则

大写字母开头 → 导出（exported），其他包可以访问，类似 public

小写字母开头 → 未导出（unexported），仅限本包内部使用，类似 private

package mathClass

// Add 是大写开头 → 其他包可以调用
func Add(x, y int) int {
    return x + y
}

// sub 是小写开头 → 只能在 mathClass 包内使用
func sub(x, y int) int {
    return x - y
}

[!warning] ⚠️ 注意如果你导入了一个包却没用它的任何导出符号，Go 编译器会直接报错：imported and not used。这强制你保持代码整洁。

3.8 KiB Raw Blame History Unescape Escape

Go 语言代码结构

概述

正文

一个 Go 程序由什么构成？

运行你的第一个程序

包与文件的关系

导出与未导出标识符

关联笔记

3.8 KiB

Raw Blame History