环境搭建

Go 装好之后，本机要能跑通三件事：go version 有输出、PATH 里能找到 go、能编译一个 hello。

安装包一律从官网下载：https://go.dev/dl/。选当前稳定版即可，不要随便用发行版仓库里很旧的包。

Windows 下的安装

1. 打开 https://go.dev/dl/，下载 Windows 的 .msi（一般是 amd64；ARM 机器选 arm64）。
2. 双击安装。默认路径是 C:\Program Files\Go，安装程序会把 C:\Program Files\Go\bin 写进系统 PATH。
3. 关掉并重新打开 终端（PowerShell / Windows Terminal），再检查：

go version
powershell

正常会类似：

go version go1.25.0 windows/amd64
text

4. 看环境变量：

go env GOPATH GOROOT
powershell

• GOROOT：Go 安装目录，一般不用改。
• GOPATH：工作区 / 工具安装目录，默认是 %USERPROFILE%\go。现在写项目用 Go Modules，不必再把源码塞进 GOPATH/src。

把 GOPATH\bin 也加进 PATH，之后 go install 装的命令才能直接敲：

# 当前用户 PATH 追加（PowerShell）
[Environment]::SetEnvironmentVariable(
  "Path",
  $env:Path + ";" + "$(go env GOPATH)\bin",
  "User"
)
powershell

若提示找不到 go，到「系统属性 → 环境变量」里确认 C:\Program Files\Go\bin 在 Path 中，然后重开终端。

Linux 下的安装

从 https://go.dev/dl/ 下载 Linux 归档包。当前稳定版常见一项如下（版本会更新，以下载页为准）：

wget https://go.dev/dl/go1.27.1.linux-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.27.1.linux-amd64.tar.gz
bash

GOROOT 一般是 /usr/local/go。不要把发行版里的 apt install golang-go 当主力环境，版本往往落后很多。

编辑环境变量

按你用的 shell，把下面两行写进 ~/.bashrc 或 ~/.zshrc：

export PATH=$PATH:/usr/local/go/bin
export PATH=$PATH:$(go env GOPATH)/bin
bash

source ~/.bashrc
go version
go env GOPATH GOROOT
bash

装完后的最小验证

任意目录新建文件 hello.go：

package main

import "fmt"

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

go run hello.go
bash

输出 hello, go 就说明编译器和运行时都通了。

新项目建议直接用 module，不要再纠结 GOPATH 工作区：

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

go env GOPROXY 在国内如果拉模块很慢，可以改成：

go env -w GOPROXY=https://goproxy.cn,direct
bash

开发工具的选择

建议打开保存时自动格式化（gofmt / goimports）。Go 的代码风格基本靠工具统一，不必自己记缩进规则。

调试：VS Code 装好 Delve（dlv）就能下断点。命令行也可以：

go install github.com/go-delve/delve/cmd/dlv@latest
bash

参考文档

官方材料按这个顺序看就够，不必同时开十个站点：

本机随时可查：

go help
go help env
go doc fmt.Println
bash