50周学习go语言：第1周 环境搭建
以下是为零基础学习者准备的详细第1周教程，包含环境搭建、工具配置和首个Go程序的完整操作指南：
一、Go语言环境安装（Windows/macOS/Linux通用）
1. 下载安装包
- 官网地址：https://go.dev/dl//
- 根据系统选择对应版本：
- Windows：下载
.msi文件（如go1.21.0.windows-amd64.msi） - macOS：下载
.pkg文件（如go1.21.0.darwin-amd64.pkg） - Linux：下载
.tar.gz文件（如go1.21.0.linux-amd64.tar.gz）
- Windows：下载
2. 安装步骤
Windows/macOS：
- 双击安装包按默认设置完成安装
- 安装路径保持默认：
- Windows：
C:\Go - macOS：
/usr/local/go
- Windows：
Linux：
# 解压到指定目录
sudo tar -C /usr/local -xzf go1.21.0.linux-amd64.tar.gz# 配置环境变量（将以下内容添加到 ~/.bashrc 或 ~/.zshrc）
export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin# 使配置生效
source ~/.bashrc
3. 验证安装
打开终端/命令行工具，输入：
go version
成功显示版本号（如 go version go1.21.0 darwin/amd64）即表示安装成功
二、VSCode配置Go开发环境
1. 安装VSCode
- 官网下载：https://code.visualstudio.com/
- 按默认设置完成安装
2. 安装Go扩展
- 打开VSCode
- 点击左侧活动栏的「扩展」图标（或按
Ctrl+Shift+X） - 搜索框输入
Go - 找到由 Go Team at Google 发布的官方插件，点击「Install」
3. 安装开发工具包
- 新建任意
.go文件（如hello.go） - VSCode右下角会自动弹出提示安装工具包
- 点击「Install All」安装以下工具：
- gopls（语言服务器）
- dlv（调试器）
- staticcheck（静态分析工具）
如遇网络问题，可先设置国内代理：
go env -w GOPROXY=https://goproxy.cn,direct
三、第一个Go程序：Hello Go!
1. 创建项目目录
mkdir hello-go
cd hello-go
2. 初始化Go模块
go mod init example.com/hello
该命令会生成 go.mod 文件，记录项目依赖信息
3. 编写代码
新建 main.go 文件，输入以下内容：
package main // 声明主包import "fmt" // 导入格式化包func main() {fmt.Println("Hello Go!") // 输出语句
}
4. 运行程序
go run main.go
终端将显示 Hello Go!
四、理解go mod机制（关键概念）
1. 模块是什么？
- 包含一组相关Go包的集合
- 通过
go.mod文件管理依赖版本 - 替代旧的GOPATH模式
2. 常用命令
| 命令 | 作用 |
|---|---|
go mod init | 初始化新模块 |
go mod tidy | 自动添加/移除依赖 |
go get | 添加新依赖 |
3. 实践操作
- 在项目中添加第三方库：
go get github.com/gin-gonic/gin
- 观察
go.mod文件变化 - 查看依赖关系图：
go mod graph
五、常见问题解决方案
-
VSCode插件安装失败：
- 检查网络连接
- 手动安装工具：
go install golang.org/x/tools/gopls@latest
-
go: command not found：
- 检查环境变量配置
- 重新打开终端使配置生效
-
代码自动补全不生效：
- 确认已安装所有推荐工具
- 重启VSCode
本周学习成果检查：
- 能正确执行
go version - 在VSCode中成功运行Hello World程序
- 理解
go.mod文件的作用 - 能够解释
package main和func main()的含义
完成这些基础准备后，你已经搭建好了专业的Go开发环境，可以开始后续的语法学习啦！