linux下只需解压go到/usr/local/go并把/usr/local/go/bin加入path即可完成基础配置,go version能运行即表示环境就绪;go 1.16+默认启用模块模式,gopath非必需,仅影响go install输出路径。

Linux下直接解压+PATH配置就足够
新手在Linux上装Go,根本不需要动GOROOT或GOPATH——只要把二进制解到/usr/local/go,再把/usr/local/go/bin加进PATH,go version能跑通,环境就算搭好了。Go 1.16之后模块模式默认开启,GOPATH仅影响go install输出位置,日常开发几乎不感知。
- 别急着设
GOPATH:除非你要用go get安装命令行工具(比如dlv),否则留默认$HOME/go就行 - 解压命令必须用
sudo tar -C /usr/local -xzf go*.tar.gz,路径错一位(比如少个-C)会导致go找不到自身 -
source ~/.bashrc后立刻执行which go确认路径生效,别只信go version
Windows/macOS用安装包,别碰手动配置
Win/macOS用户直接下.msi(Windows)或.pkg(macOS),全程点Next,安装程序会自动写PATH和GOROOT。手动改环境变量反而容易出错——比如Windows里多加个空格、macOS用zsh却改了.bashrc。
Go语言(Golang)1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口,版本号 1.26.0,可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 验证时用
go env GOROOT看路径是否指向C:\Program Files\Go(Win)或/usr/local/go(macOS),不是空值就说明自动配置成功 - 如果
go version报“command not found”,先检查终端是否重启(新终端才读取环境变量),别急着重装 - macOS M1/M2芯片务必选
darwin-arm64包,装错架构会导致go直接段错误
代理设置只在go get失败时才需要
国内新手最常卡在go get golang.org/x/tools/gopls超时,这不是环境问题,是网络策略导致的。此时只需一行命令:go env -w GOPROXY=https://goproxy.cn,direct。其他时候完全不用管代理。
- 别一上来就配代理:
go run main.go、go mod init这些基础命令根本不需要联网 -
direct必须保留,否则私有模块(如公司内网git)会拉不到 - 如果用了IDE(VS Code),插件提示“无法下载gopls”,直接在终端运行上面那行命令,重启IDE即可
VS Code装Go插件后,别点“全部安装”
VS Code首次打开.go文件时弹出的工具安装提示,只勾选gopls和go(即gofmt),其余像staticcheck、dlv等按需装。新手阶段装太多工具反而导致LSP响应慢、编辑器卡顿。
-
gopls是语言服务器核心,必须装;go提供基础格式化,够用 - 调试用
dlv?等你真要断点调试HTTP服务时再go install github.com/go-delve/delve/cmd/dlv@latest - 如果VS Code右下角一直显示“Installing tools…”,Ctrl+C中断,手动装
gopls即可
go mod init myapp + main.go里写个http.ListenAndServe就能跑起来。环境里最易被忽略的,其实是终端没重启导致PATH未生效,以及M1芯片装错arm64包——这两处错,会让所有后续操作看起来“环境没装好”。golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










