116 lines
3.8 KiB
Markdown
116 lines
3.8 KiB
Markdown
---
|
||
tags: [go, golang, go基础语法, go程序结构]
|
||
create time: 2026-06-07 15:00
|
||
---
|
||
|
||
# Go 语言代码结构
|
||
|
||
## 概述
|
||
|
||
本文介绍 Go 程序的最基本组成：包声明、导入、`main` 函数和注释，并通过 Hello World 示例带你跑通第一个 Go 程序。
|
||
|
||
## 正文
|
||
|
||
### 一个 Go 程序由什么构成？
|
||
|
||
在深入语法细节之前，先思考一个问题：**"如果让你写一个能打印 'Hello, World!' 的 Go 程序，你知道它最少需要几行代码？"**
|
||
|
||
答案是 **5 行**（不算空行和注释）。下面这个最小可运行的 Go 程序展示了所有核心要素：
|
||
|
||
```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` 后，在终端执行：
|
||
|
||
```shell
|
||
$ go run hello.go
|
||
Hello, World!
|
||
```
|
||
|
||
`go run` 会**编译并立即执行**。如果想单独生成二进制文件，用 `go build`：
|
||
|
||
```shell
|
||
$ go build hello.go # 生成 ./hello 二进制文件
|
||
$ ./hello # 运行
|
||
Hello, World!
|
||
```
|
||
|
||
> [!note] 📝 go run vs go build
|
||
> `go run` 适合快速调试；`go build` 生成独立二进制文件，方便部署和分发。
|
||
|
||
### 包与文件的关系
|
||
|
||
这是新手最容易困惑的地方。记住三条规则：
|
||
|
||
> [!warning] ⚠️ 常见误区
|
||
> 1. **文件名 ≠ 包名**：`helloworld.go` 可以是 `package main`
|
||
> 2. **文件夹名 ≠ 包名**：目录叫 `myMath`，包名可以是 `mathclass`
|
||
> 3. **同目录 = 同包**：同一个文件夹下的 `.go` 文件必须属于同一个包，否则编译报错
|
||
|
||
```mermaid
|
||
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`
|
||
|
||
```go
|
||
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`。这强制你保持代码整洁。
|
||
|
||
## 关联笔记
|
||
- [[hzh/GolangStar/Go语言基础/Go语言命名规范]]
|
||
- [[hzh/GolangStar/Go语言基础/Go语言变量]]
|