能跑go version即算环境搭通,linux用户必须手动将/usr/local/go/bin加入path,windows/macos安装器默认配置,验证时输出版本号即成功。

Go 环境能跑 go version 就算搭通了,其余都是可选增强项;Windows/macOS 用户基本装完即用,Linux 用户必须手动配置 PATH,否则命令一定报 “command not found”。
验证 go 命令是否可用
这是最核心的检验点,不通过就说明环境没生效:
- 打开终端(Windows 用 PowerShell 或 CMD,macOS/Linux 用 Terminal)
- 输入
go version,回车 - 看到类似
go version go1.22.0 linux/amd64的输出,说明二进制已就位 - 如果提示
command not found或'go' is not recognized,说明PATH没配对 —— 不是重装,是路径问题
Linux 下必须手动加 /usr/local/go/bin 到 PATH
macOS 和 Windows 安装器默认帮你加了,Linux 的 .tar.gz 包不会动你的环境变量:
- 确认 Go 解压到了哪里,常见路径是
/usr/local/go - 检查
/usr/local/go/bin是否真实存在且有go可执行文件 - 在
~/.bashrc或~/.zshrc末尾追加:export PATH=$PATH:/usr/local/go/bin - 执行
source ~/.bashrc(或source ~/.zshrc)重新加载 - 再跑
go version,必须成功
go env 不报错 ≠ 环境就完整
go env 能运行只代表 go 命令本身可执行,但很多新手会卡在后续环节:
-
go mod init失败?大概率是当前目录不在 GOPATH 里 —— 实际上 Go 1.11+ 默认启用模块模式,GO111MODULE=on才是关键 - 想快速启用模块:运行
go env -w GO111MODULE=on -
go get超时?国内用户需配代理:go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct -
GOROOT一般不用设,go自己能找到安装位置;GOPATH在模块时代也非必需,除非你还在用老式$GOPATH/src结构
第一个程序:用 go run 直接验证全流程
光看版本号还不够,得让代码真正跑起来:
- 新建一个空目录,比如
mkdir hello && cd hello - 创建
main.go,内容仅三行:package main<br>import "fmt"<br>func main() { fmt.Println("ok") } - 执行
go run main.go,终端输出ok即闭环 - 若报错
no required module provides package fmt,说明模块初始化失败 —— 先go mod init hello再试
真正容易被忽略的是:Linux 用户常以为解压完就完了,其实 PATH 那一行漏掉,所有命令都动不了;而 Windows/macOS 用户则容易在后续依赖拉取时卡住,因为没设 GOPROXY,但这个错误不会出现在 go version 阶段,得跑 go mod download 才暴露。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











