Skip to main content

环境与工具链

本模块约定 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

下一篇：基础语法