现代Go(1.16+)环境搭建无需手动配置GOROOT和GOPATH,安装程序自动完成PATH与go env设置;必须显式启用GO111MODULE=on并配置GOPROXY=https://goproxy.cn,direct,VS Code仅装官方Go插件,终端需将环境变量写入对应shell配置文件。

Go 环境搭建本身不需要“精简步骤”,而是要跳过过时、冗余或已被废弃的操作 —— 尤其是 GOPATH 手动配置、GOROOT 显式设置、以及关闭 Go Modules 这类反模式操作。现代 Go(1.16+)默认启用模块模式,go mod 已成为唯一推荐的依赖管理方式。
别再手动配 GOPATH 和 GOROOT
Go 1.11 引入 Modules 后,GOPATH 不再决定项目位置,GOROOT 也不再需要手动设(除非你自定义安装路径)。安装程序(Windows .msi / macOS .pkg / Linux tar.gz)已自动把 $GOROOT/bin 加入 PATH,且 go env 会正确识别安装目录。
- ✅ 正确做法:装完就跑
go version,成功即表示环境变量已就绪 - ❌ 错误操作:在环境变量里硬写
GOPATH=C:\Users\xxx\go或GOROOT=C:\Go—— 多数情况反而干扰模块行为 - ⚠️ 唯一例外:如果你用多版本管理工具(如
gvm或asdf),GOROOT由工具动态管理,不需人工干预
国内用户必须配的只有两个环境变量
不配代理,go get 或 go mod download 会卡死或失败;不启用 Modules,go run 可能误走 GOPATH 模式导致包找不到。
Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合,支持请求回调和结构化解析。
-
GO111MODULE=on(Go 1.16+ 已默认开启,但旧终端可能残留 off,建议显式设) -
GOPROXY=https://goproxy.cn,direct(比https://proxy.golang.org更稳定,支持私有模块 fallback) - 不用设
GOSUMDB——goproxy.cn自带校验和服务,设了反而可能冲突
VS Code 里不要装“Go for Visual Studio Code”旧插件
官方插件已更名为 Go(作者:Go Team),旧插件(Go for Visual Studio Code)停止维护,会导致 dlv 调试器下载失败、gopls 版本错乱。
立即学习“go语言免费学习笔记(深入)”;
- 安装前先卸载所有带 “for Visual Studio Code” 字样的 Go 插件
- 只装官方
Go插件(ID:golang.go),它会自动拉取匹配 Go 版本的gopls和dlv - 首次打开 Go 文件时,如果弹出 “Install tools”,点 “Install All” —— 它会走你设好的
GOPROXY,不会卡在golang.org/x/...
真正容易被忽略的是:每次新开终端(尤其是 PowerShell 或 WSL),环境变量不是自动继承的。Windows 用户用 setx 永久写入,macOS/Linux 用户务必把 export 写进 ~/.zshrc(不是 ~/.bashrc,除非你没换 shell)—— 否则 go mod 在终端里正常,在 VS Code 终端里却报错,这种割裂最让人抓狂。

















