第二篇：《Go 开发环境搭建：SDK、IDE、Module 与 Hello World》

环境搭建是学习任何一门语言的第一步。Go 的环境配置相比 C 和 Java 要简单得多——没有复杂的 IDE 配置没有漫长的编译等待。但 Go 在 1.11 版本引入 Go Modules 后彻底改变了项目结构的管理方式不再依赖传统的 GOPATH。本文将手把手带你完成 Go SDK 的安装、环境变量配置、IDE 选择与配置并创建你的第一个 Go Module 项目写出经典的 “Hello World”。跟着操作20 分钟内拥有一个可用的 Go 开发环境。一、安装 Go SDK1.1 下载安装包Go 的官方下载地址为 go.dev/doc/install。根据你的操作系统选择对应的安装包 国内加速如果官方下载慢可以使用 Go 中文社区镜像站 golang.google.cn 或 studygolang.com/dl。1.2 Windows 安装双击下载的 .msi 文件一路 “Next” 完成安装。默认安装路径为 C:\Program Files\Go。安装程序会自动将 C:\Program Files\Go\bin 添加到系统 PATH 中。验证安装打开命令提示符CMD或 PowerShell执行go version如果看到类似 go version go1.23.0 windows/amd64 的输出说明安装成功。1.3 macOS 安装双击下载的 .pkg 文件按提示完成安装。默认安装路径为 /usr/local/go安装程序会自动配置 PATH。验证安装打开终端执行 go version。1.4 Linux 安装以 Ubuntu 为例# 下载最新版本替换为实际版本号wgethttps://go.dev/dl/go1.23.0.linux-amd64.tar.gz# 解压到 /usr/localsudotar-C/usr/local-xzfgo1.23.0.linux-amd64.tar.gz# 将 Go 添加到 PATHechoexport PATH$PATH:/usr/local/go/bin~/.bashrcsource~/.bashrc# 验证go version二、环境变量GOROOT、GOPATH、GOBIN 与 GOPROXY虽然 Go 安装后即可直接使用但了解几个关键环境变量对后续开发至关重要。2.1 GOROOTGo 的安装目录GOROOT 指向 Go SDK 的安装路径包含编译器、标准库等核心组件。安装程序通常会自动配置此变量一般无需手动修改。仅在需要切换多个 Go 版本时才需要调整。Windows 默认C:\Program Files\GomacOS/Linux 默认/usr/local/go2.2 GOPATH工作区目录Go Modules 模式下已弱化GOPATH 是 Go 早期版本的工作区路径用于存放源码src、编译后的文件pkg和可执行文件bin。在 Go Modules 成为标准后项目不再强制放在 GOPATH/src 下可以放在任意目录。 建议虽然 Go Modules 已不再强制依赖 GOPATH但建议仍设置一个 GOPATH 目录如 ~/go用于存放全局安装的工具和依赖。设置 GOPATHLinux/macOSechoexport GOPATH$HOME/go~/.bashrcechoexport PATH$PATH:$GOPATH/bin~/.bashrcsource~/.bashrc2.3 GOBIN可执行文件输出目录可选GOBIN 指定 go install 命令安装的可执行文件的存放目录。如果不设置默认输出到 $GOPATH/bin。2.4 GOPROXY模块代理配置由于国内访问 GitHub 和 Google 的源可能较慢可配置 Go 模块代理# Linux/macOSgoenv-wGOPROXYhttps://goproxy.cn,direct# Windows (CMD)goenv-wGOPROXYhttps://goproxy.cn,direct常用的代理有https://goproxy.cn七牛云国内推荐https://proxy.golang.org国内可能较慢https://goproxy.io第三方三、Go Modules现代 Go 项目的依赖管理Go Modules 是 Go 官方推出的依赖管理解决方案从 Go 1.11 开始引入Go 1.16 后成为默认行为。它彻底摆脱了对 GOPATH 的依赖让 Go 项目可以放在任意目录。3.1 初始化一个新模块假设我们要创建一个名为 hello 的项目# 创建项目目录可以在任何位置mkdirhellocdhello# 初始化 Go 模块go mod init hello go mod init 会生成一个 go.mod 文件内容类似 go module hello go1.23module hello定义模块名称通常为项目的导入路径如 github.com/username/projectnamego 1.23指定 Go 版本3.2 添加依赖当你在代码中 import 一个外部包并执行 go build 或 go run 时Go 会自动下载依赖并更新 go.mod 和 go.sum 文件。# 手动添加依赖go get github.com/gin-gonic/gin3.3 常用 go mod 命令四、IDE 选择与配置4.1 VS Code推荐新手VS Code 是 Go 开发最流行的免费 IDE配合官方 Go 插件体验极佳。安装步骤安装 VS Code。打开 VS Code点击左侧 Extensions或按 CtrlShiftX。搜索 Go安装由 Go 团队官方维护的插件golang.go。打开一个 .go 文件或 go.mod 文件插件会自动激活。按提示安装 Go 工具gopls、dlv、gofmt、goimports 等。常用配置settings.jsonjson{“go.useLanguageServer”: true,“go.formatTool”: “gofmt”,“go.lintTool”: “golangci-lint”,“[go]”: {“editor.formatOnSave”: true,“editor.codeActionsOnSave”: {“source.organizeImports”: “explicit”}}}4.2 GoLand专业付费GoLand 是 JetBrains 出品的专业 Go IDE开箱即用功能强大。创建新项目打开 GoLand点击 New Project。选择 Go 项目类型。GOROOT 字段会自动检测 Go 安装路径。勾选 Enable Go modules integration。点击 Create。4.3 其他选项Vim/Neovim配合 vim-go 插件Emacs配合 go-modeSublime Text配合 GoSublime五、第一个 Go 程序Hello World5.1 创建项目mkdirhellocdhello go mod init hello5.2 编写代码创建 main.go 文件packagemainimportfmtfuncmain(){fmt.Println(Hello, World!)}5.3 运行与编译# 直接运行不生成可执行文件go run main.go# 输出: Hello, World!# 编译为可执行文件go build main.go# 生成 mainLinux/macOS或 main.exeWindows# 运行编译后的文件./main# Linux/macOSmain.exe# Windows六、常用 Go 工具七、小结Go SDK 安装从 go.dev 下载对应平台的安装包安装后执行 go version 验证。环境变量GOROOT安装路径、GOPATH工作区、GOBIN输出目录、GOPROXY代理加速强烈建议配置。Go Modules现代 Go 项目的标准依赖管理方式go mod init 初始化go mod tidy 整理依赖。IDEVS Code Go 插件免费推荐或 GoLand专业付费。第一个程序package main func main() fmt.Printlngo run 运行。