以下是为零基础学习者准备的详细第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）

2. 安装步骤

Windows/macOS：

• 双击安装包按默认设置完成安装
• 安装路径保持默认：
  • Windows：C:\Go
  • macOS：/usr/local/go

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扩展

1. 打开VSCode
2. 点击左侧活动栏的「扩展」图标（或按 Ctrl+Shift+X）
3. 搜索框输入 Go
4. 找到由 Go Team at Google 发布的官方插件，点击「Install」

3. 安装开发工具包

1. 新建任意 .go 文件（如 hello.go）
2. VSCode右下角会自动弹出提示安装工具包
3. 点击「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. 实践操作

1. 在项目中添加第三方库：

go get github.com/gin-gonic/gin

2. 观察 go.mod 文件变化
3. 查看依赖关系图：

go mod graph

---

五、常见问题解决方案

1. VSCode插件安装失败：

   • 检查网络连接
   • 手动安装工具：

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

2. go: command not found：

   • 检查环境变量配置
   • 重新打开终端使配置生效

3. 代码自动补全不生效：

   • 确认已安装所有推荐工具
   • 重启VSCode

---

本周学习成果检查：

• 能正确执行 go version
• 在VSCode中成功运行Hello World程序
• 理解 go.mod 文件的作用
• 能够解释 package main 和 func main() 的含义

完成这些基础准备后，你已经搭建好了专业的Go开发环境，可以开始后续的语法学习啦！