步骤概述:
-
安装Visual Studio Code (VSCode)
-
安装Go语言(Golang)
-
配置Go环境变量(GOROOT, GOPATH)
-
安装VSCode的Go扩展
-
创建一个Go项目
-
编写一个简单的Go程序
-
运行和调试Go程序
下面是在VSCode中进行Go开发的详细步骤,包括环境安装、配置和项目创建:
1. 安装VSCode
- 访问 VSCode官网
- 下载对应操作系统的安装包(Windows/macOS/Linux,如果macos系统,注意芯片的类型,比如intel还是m1/m2/m3等)
- 按默认设置完成安装
2. 安装Go语言
Windows/macOS:
- 访问 Go官网下载页
- 下载最新稳定版的安装包(
.msi或.pkg) - 双击安装(默认路径:
C:\Go\或/usr/local/go)
Linux:
# 下载解压到 /usr/local
wget https://go.dev/dl/go1.22.3.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.22.3.linux-amd64.tar.gz
3. 配置环境变量
Windows:
- 打开系统设置 → 搜索“环境变量”
- 在 系统变量 中:
- 新建
GOROOT:值为C:\Go(Go安装路径) - 新建
GOPATH:值为你的工作目录(例如D:\go_workspace) - 编辑
Path:添加%GOROOT%\bin和%GOPATH%\bin
- 新建
macOS/Linux:
编辑 ~/.bashrc 或 ~/.zshrc:
export GOROOT=/usr/local/go
export GOPATH=$HOME/go_workspace # 自定义工作目录
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
运行生效:
# 具体是哪一个文件,需要看你的shell是bash还是zsh
source ~/.bashrc # 或 source ~/.zshrc
验证安装:
go version # 显示版本即成功(如 go1.22.3)
4. VSCode配置Go扩展
- 打开VSCode
- 安装官方Go扩展:
- 搜索
Go→ 选择 Go Team at Google 的扩展
- 搜索
- 安装必备工具(自动提示):
- 按
Ctrl+Shift+P→ 输入Go: Install/Update Tools - 全选所有工具 → 点击 OK(需科学上网)
- 按
5. 创建Go项目
(1) 初始化项目
mkdir hello-go
cd hello-go
go mod init example.com/hello # 初始化Go模块(项目名)
# 执行完上面的命令之后, 会在你的项目的根目录下, 生成一个go.mod文件
(2) 编写代码
- 在项目中创建
main.go:package main import "fmt" func main() { fmt.Println("Hello, Go!") }
(3) 项目结构
hello-go/
├── go.mod # 模块定义
└── main.go # 主程序
6. 运行与调试
运行程序:
- 方法1(终端):
go run main.go # 输出 Hello, Go! - 方法2(VSCode):
- 打开
main.go - 点击右上角的 Run 三角按钮
- 打开
调试程序:
- 在代码行号左侧点击设置断点
- 按
F5启动调试(自动生成launch.json) - 使用调试控制台查看变量/执行流程
7. 关键配置说明
GOROOT:Go的安装路径(自动识别,通常无需手动设)GOPATH(旧版):src:存放源代码pkg:编译后的库文件bin:可执行文件
- Go Modules(推荐):
- 使用
go mod init管理依赖(项目独立环境) - 依赖包自动下载到
$GOPATH/pkg/mod
- 使用
8. 安装依赖示例
# 例如安装gin框架
go get -u github.com/gin-gonic/gin
代码中引用:
import "github.com/gin-gonic/gin"
常见问题解决
- 工具安装失败:
- 设置国内代理(终端执行):
go env -w GO111MODULE=on go env -w GOPROXY=https://goproxy.cn,direct
- 设置国内代理(终端执行):
- VSCode报错:重启VSCode或重新安装Go扩展
- 环境变量不生效:重启终端或电脑
按照以上步骤,你已成功搭建Go开发环境并运行了第一个程序!后续可扩展学习:
- 调试配置(
.vscode/launch.json) - 单元测试(
go test) - 包管理(
go mod)