Golang环境搭建详细教程

有志者，事竟成！如果你在学习Golang，那么本文《Golang开发环境搭建教程》，就很适合你！文章讲解的知识点主要包括，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

Go开发环境搭建需正确配置PATH、GOPROXY和GO111MODULE，禁用GOPATH依赖，新建模块用go mod init，避免在$GOPATH/src下创建项目，推荐VS Code+gopls组合。

Go 语言开发环境搭建本身不复杂，但容易在 GOPATH、GOBIN、模块模式与 go install 行为上踩坑，尤其当你混用老项目（依赖 vendor）和新模块项目时。

下载安装 Go 并验证版本

从官网 https://go.dev/dl/ 下载对应系统安装包（macOS 推荐 .pkg，Linux 推荐 tar.gz），安装后必须验证是否生效：

go version

输出应类似 go version go1.22.3 darwin/arm64。若提示 command not found: go，说明 PATH 未正确配置——macOS/Linux 检查 ~/.zshrc 或 ~/.bash_profile 是否添加了 export PATH=$PATH:/usr/local/go/bin；Windows 则需在「系统属性 → 高级 → 环境变量」中确认 Path 包含 C:\Go\bin。

初始化 GOPROXY 和启用模块模式

国内直连 proxy.golang.org 常失败，必须设置代理；同时 Go 1.16+ 默认启用模块（module）模式，但部分旧脚本仍隐式依赖 GOPATH，建议显式关闭兼容路径干扰：

• 运行 go env -w GOPROXY=https://goproxy.cn,direct
• 运行 go env -w GO111MODULE=on（强制开启模块，避免因目录位置触发自动降级）
• 不必再手动设置 GOPATH：现代 Go 已默认使用 $HOME/go，且仅用于存放 pkg、bin 和全局缓存，项目根目录无需在 GOPATH 内

创建第一个模块并运行

新建任意空目录（如 ~/hello），执行：

go mod init hello
echo 'package main\n\nimport "fmt"\n\nfunc main() { fmt.Println("Hello, Go!") }' > main.go
go run main.go

关键点：

• go mod init 会生成 go.mod，模块名不一定要是域名，本地练习用 hello 完全合法
• 不要在 $GOPATH/src 下创建项目——这是旧模式残留习惯，现在会导致 go run 报 cannot find module providing package
• 如果看到 go: downloading ... 日志，说明代理生效；若卡住，检查 go env GOPROXY 输出是否正确

配置常用工具链（可选但推荐）

VS Code + gopls 是目前最稳的组合。安装 VS Code 后，装官方 Go 插件（由 golang.org/x/tools 提供），它会自动下载 gopls（Go language server）。若手动安装：

go install golang.org/x/tools/gopls@latest

注意：go install 默认把二进制写入 $HOME/go/bin，确保该路径已在 PATH 中，否则 VS Code 找不到 gopls。另外，禁用 go.gopath 相关设置（如 "go.gopath" 字段），现代开发已无需手动指定 GOPATH。

真正容易被忽略的是：每次新开终端后，go env 设置是否持久生效；以及 go run 和 go build 对当前目录的模块感知是否一致——它们都依赖 go.mod 是否存在，而不是路径深度或父目录结构。

到这里，我们也就讲完了《Golang环境搭建详细教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！