环境搭好只需三步:go version能运行、go mod init成功、go run main.go通;其余如gopath/goroot配置、goproxy设置等均为可选优化项,新版go(1.16+)默认行为已足够简洁可靠。

go version 能跑出来,环境就算搭好了——其他都是可选优化项。别被 GOPATH、GOROOT、GO111MODULE 这些词绕晕,新版 Go(1.16+)默认行为已足够干净。
验证 go 命令是否真可用
很多人卡在这一步:明明安装了,但终端里敲 go version 报错 command not found 或 'go' is not recognized。
- Windows 用户检查安装时是否勾选了 “Add Go to PATH”(新版 .msi 默认勾选,老版本可能没勾);没勾就手动把
C:\Go\bin加进系统环境变量PATH - macOS/Linux 用户如果用 Homebrew 安装(
brew install go),通常自动生效;若手动解压 tar.gz 到/usr/local/go,需确认/usr/local/go/bin在PATH里(echo $PATH看一眼) - 新开一个终端再试,别信当前终端的缓存——尤其 macOS 上 zsh/bash 切换后容易漏 reload
初始化项目时直接用 go mod init,别碰 GOPATH/src
你不需要提前建 $GOPATH/src/github.com/xxx/yyy 这种路径。Go Modules 模式下,项目可以放在任意目录,比如桌面、/tmp、甚至 ~/myproject。
- 新建空目录,
cd进去,直接运行go mod init myapp(模块名不强制用域名,能唯一标识就行) - 生成的
go.mod文件里会自动写入 Go 版本(如go 1.22),这个版本号影响编译兼容性,别手动删 - 如果后续要
import第三方包(比如github.com/gin-gonic/gin),go run或go build时会自动下载并记录到go.mod和go.sum
国内用户必须配 GOPROXY,否则 go get 卡死
不配代理,go mod download 会尝试访问 proxy.golang.org 和 golang.org/x/...,99% 情况下超时或失败。
- 执行这条命令(永久生效):
go env -w GOPROXY=https://goproxy.cn,direct -
direct表示对私有仓库(比如公司内网 Git)不走代理,直连——这个保留很重要,删了会导致内部包拉不到 - 验证是否生效:
go env GOPROXY应输出https://goproxy.cn,direct - 如果公司有自建代理(如 Nexus),替换成对应地址,格式一样
VS Code 装插件后别急着点“Install All Tools”
VS Code 的 Go 插件首次打开 .go 文件时会弹窗问要不要装 gopls、dlv、goimports 等工具——但部分工具在某些网络环境下会卡住或失败。
- 先点“Cancel”,然后手动在终端运行:
go install golang.org/x/tools/gopls@latest - 再回到 VS Code,按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS),输入 “Go: Install/Update Tools”,勾选全部(除了可能灰色的),点 OK - 如果某工具始终装不上(比如
staticcheck),不影响基础编码和调试,可跳过
go version 成功 + go mod init 成功 + go run main.go 跑通,就已经具备完整开发能力。其余配置都是为团队协作、CI/CD 或特定框架服务的,初期完全可延后。golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











