当前位置：首页 > article >正文

50周学习go语言：第1周环境搭建

article 2025/2/24 16:38:25

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

打开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