环境与工具链

本模块约定 Go 1.22+。先装好工具链，再学会怎么跑与格式化代码。

安装

• macOS：官网安装包，或 brew install go
• Windows：官网 MSI，安装后确认 go 在 PATH 中
• Linux：官网 tarball / 发行版包（注意版本是否 ≥ 1.22）

安装后检查：

go version
# 期望类似：go version go1.22.x ... / go1.23.x ...

官方下载：https://go.dev/dl/

跑起来：go run / go build / go install

新建目录并初始化模块（详情见「包与模块初识」）：

mkdir hello && cd hello
go mod init example.com/hello

main.go：

package main

import "fmt"

func main() {
	fmt.Println("hello, go")
}

常用命令：

命令	作用
go run . 或 go run main.go	编译到临时目录并立刻执行（开发调试）
go build	在当前目录生成可执行文件（Windows 为 .exe）
go install	编译并装到 $(go env GOPATH)/bin（需该目录在 PATH）

go run .
go build -o hello
./hello

查看环境变量：

go env GOROOT GOPATH GOMODCACHE

日常写业务代码以 模块（go.mod） 为准即可，不必先深挖旧式 GOPATH 模式。

工作区与目录习惯

典型小项目：

hello/
  go.mod
  main.go
  internal/   # 可选：仅本模块可用的包
  pkg/        # 可选：希望被外部引用的库（非必须）

• 一个目录一个 package（文件头 package xxx 一致）
• 可执行程序的包名通常是 main，且有 func main()
• 依赖进 go.mod / go.sum，用 go get / go mod tidy 管理（见进阶「工程与依赖管理」）

格式化与编辑器

Go 强制统一风格，工具链自带格式化：

gofmt -w .
# 或
go fmt ./...

编辑器安装 gopls（官方语言服务）后可获得补全、跳转、诊断。VS Code / Cursor 装官方 Go 扩展即可。

其他常用命令（后文会用到）：

go test ./...
go vet ./...

小结

1. go version 确认 ≥ 1.22
2. go mod init + go run . 跑通第一程序
3. 用 gofmt / gopls，少纠结空格与导入顺序
4. 以模块目录组织代码，而不是死记 GOPATH

下一篇：基础语法