Go环境能跑起来的关键是go命令被系统和IDE正确识别、模块正常下载、项目加载依赖；Windows上安装后提示“go不是内部或外部命令”是PATH未生效的典型表现，需检查安装路径、手动添加bin目录到PATH并重启终端。
Go 环境能跑起来，关键不是装了没，而是 go 命令能否被系统和 IDE 正确识别、模块能否正常下载、项目能否加载依赖——这三件事卡住，main.go 写完也点不了运行按钮。
Windows 上 .msi 安装后仍提示“go 不是内部或外部命令”
这是 PATH 没生效的典型表现，哪怕安装程序声称已添加，也常因用户权限、终端缓存或安装路径含空格而失效。
- 打开 PowerShell 或 CMD，执行
where go，若无输出，说明go.exe确实不在 PATH 中 - 手动检查安装目录（如
C:\Program Files\Go\bin）是否存在go.exe；若路径含空格（如C:\Program Files\Go），建议重装到无空格路径（如D:\Go\bin） - 在“环境变量”中编辑系统 PATH，新增一行：
D:\Go\bin（不要加引号，也不要写%GOROOT%\bin这种变量引用） - 关闭所有终端窗口再新开一个，再试
go version；旧终端不会自动继承新 PATH
Mac 上用 brew install go 后 go env GOROOT 返回空或错误路径
Homebrew 安装的 Go 通常不设 GOROOT 环境变量，而是靠工具链自发现；但某些 IDE（如 GoLand）会强制读取该变量，导致识别失败。
- 运行
go env GOROOT，如果为空或指向错误路径（比如/usr/local/go但实际在/opt/homebrew/Cellar/go/1.25.0/libexec），说明未显式设置 - 执行
brew --prefix go查出真实安装根路径（如/opt/homebrew/Cellar/go/1.25.0），其子目录libexec就是真正的GOROOT - 在
~/.zshrc（或~/.bash_profile）中添加：export GOROOT=$(/opt/homebrew/bin/brew --prefix go)/libexec - 执行
source ~/.zshrc，再验证go env GOROOT是否输出正确路径
GoLand 中 go run 正常但测试图标不显示、import 标红
这不是代码问题，是 IDE 没加载模块上下文，常见于 go.work 干扰或模块代理配置缺失。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
立即学习“go语言免费学习笔记（深入）”；
- 检查项目根目录是否存在
go.work文件；如有，直接删掉——它会覆盖单模块行为，让 GoLand 误判为多模块工作区 - 进入 Settings → Go → Go Modules，确认勾选了 “Enable Go modules integration”
- Proxy 字段必须填完整：
https://goproxy.cn,direct；只写https://goproxy.cn会导致私有模块解析失败，进而阻断依赖加载 -
GOROOT必须指向包含src、pkg、bin的根目录（如/usr/local/go），不能指向/usr/local/go/bin - 改完设置后，必须重启 GoLand；仅 Reload project 无效，GUI 进程不重读环境变量
Linux 下 apt install golang-go 导致 go mod 报错“unknown subcommand”
Ubuntu 官源的 golang-go 包版本老旧（常为 1.19 或更早），不支持现代模块命令，且默认禁用模块模式。
- 运行
go version，若显示go1.19.x或更低，基本可判定是源码包陈旧所致 - 卸载：
sudo apt remove golang-go，并清空/usr/lib/go（如有） - 改用官方二进制安装：从
https://go.dev/dl/下载go1.25.x.linux-amd64.tar.gz，解压到/usr/local，再设置PATH=/usr/local/go/bin:$PATH - 验证
go env GO111MODULE应为on；若为auto或空，手动设为export GO111MODULE=on
环境变量本身不复杂，难的是每一步都得对齐：shell 认的、IDE 读的、go 工具链用的，三者路径和开关状态必须一致。少一个 direct、多一个 /bin、漏一次重启，就卡在“看起来装好了，其实没通”。
