go环境搭建成功只需go version能正常输出版本号,windows用msi安装自动配置path,macos推荐brew install go,linux需手动配置path并验证,国内必须执行go env -w goproxy=https://goproxy.cn,direct才能顺利拉取依赖。

go version 能跑通,环境就算搭好了——其他全是锦上添花。别被“完整配置”“最佳实践”带偏节奏,先让 go run main.go 输出一行 Hello, world,才是真实起点。
Windows 上装 Go:msi 安装包 + 验证命令就够了
下载 .msi 文件(比如 go1.24.4.windows-amd64.msi),双击安装,路径选默认(C:\Program Files\Go\)就行。它会自动把 C:\Program Files\Go\bin 加进系统 PATH。
关键验证步骤只有一步:
- 新开一个 PowerShell 或 CMD 窗口(旧窗口不生效)
- 执行
go version - 看到类似
go version go1.24.4 windows/amd64就成功了
不用手动配 GOROOT,也不用急着改 GOPATH——Go 1.14+ 默认启用 module 模式,go mod init 后项目就独立于 GOPATH。
macOS 用户优先用 Homebrew,避免 pkg 安装后权限或路径问题
brew install go 是最稳的路径,装完直接可用。如果用了 .pkg 安装,偶尔会遇到 /usr/local/go/bin 没进 shell 的 PATH(尤其 zsh 用户)。
常见卡点:
- 执行
go version报错command not found - 检查
echo $PATH是否含/usr/local/go/bin - 若缺失,在
~/.zshrc末尾加一行:export PATH="/usr/local/go/bin:$PATH",再source ~/.zshrc
别碰 GOROOT 手动设置——Homebrew 管理的路径是受控的,硬写反而容易冲突。
Linux 手动解压后,PATH 配置最容易漏掉 sudo 权限或 shell 类型
下载 go1.24.4.linux-amd64.tar.gz,解压到 /usr/local 是常规做法:
Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合,支持请求回调和结构化解析。
sudo tar -C /usr/local -xzf go1.24.4.linux-amd64.tar.gz
但很多人卡在环境变量这步:
- 用
sudo nano /etc/profile写入export PATH=$PATH:/usr/local/go/bin,却忘了source /etc/profile或重启终端 - 或者误改了
~/.bashrc,但当前 shell 是zsh(Ubuntu 22.04+ 默认) - 验证时别用
which go,直接go version——它更能暴露 PATH 是否真生效
临时测试可运行 /usr/local/go/bin/go version,能出结果说明二进制没问题,纯是 PATH 问题。
国内用户必须设 GOPROXY,否则 go mod download 会卡死
装完 Go 后立刻执行:
go env -w GOPROXY=https://goproxy.cn,direct
这是唯一绕不开的代理配置。不设的话,新建模块后执行 go mod tidy 或 go run 依赖网络包时,会卡在 Fetching github.com/xxx 十几秒甚至超时失败。
注意:
-
direct在最后保留,表示私有仓库走直连 - 别用已停服的
https://goproxy.io(2025 年底已下线) - 如果公司内网有自建代理,优先用内部地址,而非公共镜像
真正麻烦的从来不是装 Go,而是装完后第一次拉依赖时那漫长的沉默——设好 GOPROXY 才算环境真正可用。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










