[Macos]vscode+golang(安装+环境配置+项目创建)

482 阅读3分钟

步骤概述:

  1. 安装Visual Studio Code (VSCode)

  2. 安装Go语言(Golang)

  3. 配置Go环境变量(GOROOT, GOPATH)

  4. 安装VSCode的Go扩展

  5. 创建一个Go项目

  6. 编写一个简单的Go程序

  7. 运行和调试Go程序

下面是在VSCode中进行Go开发的详细步骤,包括环境安装、配置和项目创建:


1. 安装VSCode

  1. 访问 VSCode官网
  2. 下载对应操作系统的安装包(Windows/macOS/Linux,如果macos系统,注意芯片的类型,比如intel还是m1/m2/m3等)
  3. 按默认设置完成安装

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:

  1. 打开系统设置 → 搜索“环境变量”
  2. 系统变量 中:
    • 新建 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扩展

  1. 打开VSCode
  2. 安装官方Go扩展:
    • 搜索 Go → 选择 Go Team at Google 的扩展
  3. 安装必备工具(自动提示):
    • 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) 编写代码

  1. 在项目中创建 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)
    1. 打开 main.go
    2. 点击右上角的 Run 三角按钮

调试程序:

  1. 在代码行号左侧点击设置断点
  2. F5 启动调试(自动生成 launch.json
  3. 使用调试控制台查看变量/执行流程

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"

常见问题解决

  1. 工具安装失败
    • 设置国内代理(终端执行):
      go env -w GO111MODULE=on
      go env -w GOPROXY=https://goproxy.cn,direct
      
  2. VSCode报错:重启VSCode或重新安装Go扩展
  3. 环境变量不生效:重启终端或电脑

按照以上步骤,你已成功搭建Go开发环境并运行了第一个程序!后续可扩展学习:

  • 调试配置(.vscode/launch.json
  • 单元测试(go test
  • 包管理(go mod