Go环境能跑起来的关键是go命令全局可用、go run可直接执行、模块依赖正常下载；需验证PATH配置、GO111MODULE=on、gopls和dlv正确安装并加入PATH。
Go语言环境能跑起来，关键不在装多少工具，而在 go 命令能否在任意目录下执行、go run 能直接运行代码、模块依赖能正常下载。轻量终端（如 Termux、Windows Terminal + WSL、macOS 终端）配置得当，比图形 IDE 更快启动、更少干扰。
go 命令找不到？检查 PATH 和二进制位置
这是最常卡住的第一步。不是“装了 Go 就行”，而是 shell 必须知道 go 在哪。
- Linux/macOS：确认
go二进制是否在$GOROOT/bin（如/usr/local/go/bin），然后把它加进PATH。常见错误是只改了~/.bashrc却忘了source ~/.bashrc，或用了 zsh 没改~/.zshrc - Windows（WSL）：路径通常是
/usr/local/go/bin，别用 Windows 的C:\Go\bin—— WSL 看不到它 - Termux：直接
pkg install golang后，go就在/data/data/com.termux/files/usr/bin，已自动加入 PATH，无需手动操作 - 验证方式：新开一个终端窗口，运行
go version和which go，两者都应有输出且路径一致
GO111MODULE=on 是默认值，但旧项目或 GOPATH 模式仍会触发问题
Go 1.16+ 默认启用模块模式，但某些老教程或遗留脚本会显式设为 off，导致 go get 报错 “cannot find module providing package”。
- 运行
go env -w GO111MODULE=on强制开启（推荐） - 如果项目根目录下有
vendor/目录且你想复用它，可临时设为go env -w GO111MODULE=auto，但不建议长期依赖 vendor -
GOPATH不再决定项目位置，仅影响go install工具的存放路径（如gopls、goimports），所以不用为每个项目设不同GOPATH - 检查当前状态：
go env GO111MODULE输出应为on
终端里写 Go 代码，缺的是补全和格式化，不是 GUI
轻量终端本身不提供语法提示，但可通过命令行工具 + 编辑器插件补足，核心是让 gopls 跑起来。
立即学习“go语言免费学习笔记（深入）”；
- 先装语言服务器：
go install golang.org/x/tools/gopls@latest，成功后gopls会出现在$GOPATH/bin（确保该路径在PATH中） - VS Code 用户：装好 Go 扩展后，首次打开
.go文件会弹窗提示安装工具——务必点 “Install All”，否则gopls、goimports、delve都不会就位 - Vim/Neovim 用户：用
vim-go插件时，运行:GoInstallBinaries手动拉取依赖，别跳过 - 格式化默认用
gofmt，但建议换成gofumpt（更严格）：go install mvdan.cc/gofumpt@latest，然后在编辑器设置里指定格式化工具为gofumpt
Termux 或 WSL 下调试失败？delve 启动路径不对
delve 是 Go 官方调试器，但它不是靠 IDE 自动发现的，而是靠 dlv 命令是否存在以及能否执行。
- 安装：
go install github.com/go-delve/delve/cmd/dlv@latest - 验证：
dlv version应输出版本号；若报 “command not found”，说明$GOPATH/bin没进PATH - Termux 特别注意：ARM64 设备（如新 iPad 或部分安卓手机）需确认
dlv是否支持该架构，可查dlvrelease 页面是否有linux-arm64或android-arm64构建包 - WSL2 中调试时，避免用
dlv attach去 attach Windows 进程——跨子系统不行，只能 debug WSL 内部运行的go程序
真正容易被忽略的不是“怎么装”，而是每次新开终端后 PATH 是否生效、gopls 是否真被编辑器调用、dlv 是否在 PATH 里且有执行权限——这些细节不验证，轻量环境反而比图形 IDE 更难排查。
