先确认Go是否安装成功,再将Go的bin目录添加到系统PATH环境变量中;Linux/macOS用户需在shell配置文件中添加GOROOT和PATH,Windows用户需在环境变量中添加Go的bin路径,并重启终端验证。

安装 Golang 后提示 "go command not found",说明系统无法识别 go 命令。这通常是因为 Go 的可执行文件路径没有正确添加到系统的环境变量中。下面介绍常见平台下的排查与解决方法。
检查 Go 是否已正确安装
先确认 Go 是否真的安装成功:
- 进入你解压或安装 Go 的目录,查看是否存在
bin/go可执行文件。 - 在终端中运行:/path/to/go/bin/go version(替换为实际路径)。
- 如果能正常输出版本信息,说明 Go 已安装,只是环境变量未配置。
配置环境变量(关键步骤)
必须将 Go 的 bin 目录加入 PATH 环境变量,系统才能在任意位置调用 go 命令。
- 打开终端,编辑 shell 配置文件,如:
~/.bashrc、~/.zshrc或~/.profile。 - 添加以下内容(假设 Go 安装在
/usr/local/go):
export PATH=$PATH:$GOROOT/bin
- 保存后执行:
source ~/.zshrc(或对应文件)使配置生效。 - 输入
go version测试是否成功。
- 打开“系统属性” → “高级” → “环境变量”。
- 在“系统变量”中找到
Path,点击“编辑”。 - 新增一项:
C:\Go\bin(根据实际安装路径调整)。 - 打开新的命令提示符窗口,输入
go version验证。
确认 Shell 使用的是正确的配置
有时修改了配置文件但未生效,可能是因为:
立即学习“go语言免费学习笔记(深入)”;
- 使用的是 zsh 但修改了 .bashrc(应改 .zshrc)。
- 没有重新加载配置文件(记得运行
source命令)。 - 终端未重启,旧的 PATH 仍被缓存。
使用包管理器安装的情况
如果你是通过 homebrew(macOS)或 snap、apt(Linux)安装的 Go:
- 通常会自动配置 PATH,但个别情况下需要手动处理。
- 可通过
which go查看是否已被软链接到/usr/local/bin等标准路径。 - 若路径异常,建议重新安装或手动符号链接。
基本上就这些。只要确保 go 所在的 bin 目录在 PATH 中,问题就能解决。不复杂但容易忽略。










