Go 环境配置指南

2025-02-17

在开发 Go 语言项目时，正确配置环境是至关重要的第一步。本文将为你详细介绍 Go 在不同系统上的环境配置方法，帮助你快速上手 Go 开发。

一、Windows 系统

（一）安装 Go

首先，前往 Go 语言官方网站（https://golang.or g/dl/ ）下载适用于 Windows 的安装包。根据你的系统是 32 位还是 64 位，选择对应的安装文件。

下载完成后，双击安装包进行安装。安装过程中，按照提示一步步操作即可，默认安装路径通常为C:\Program Files\Go 。

（二）设置环境变量

1. 设置 GOPROXY：

打开命令提示符（CMD）。

执行以下命令修改 Go 的代理，以解决国内下载依赖库困难的问题。这里设置了两个常用的代理，可根据实际情况选择：
```
go env -w GOPROXY=https://goproxy.cn,direct
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/
```

2. 修改 GOPATH：

你可以使用以下命令将 GOPATH 设置为你想要的目录，比如f:\mygo ：
go env -w GOPATH=f:\mygo
或者在命令提示符中临时设置： set GOPATH=f:\mygo
查看 GOPATH 设置是否正确：
```
go env GOPATH
echo %GOPATH%
```

（三）VS Code 配置 Go 开发环境

安装 VS Code 编辑器，并在扩展商店中搜索并安装 “Go” 扩展。

打开 VS Code，点击左下角的设置图标，选择 “设置”。

在搜索框中输入 “go”，找到 “Go: Configuration” 选项，点击 “编辑设置 (JSON)”。

在打开的配置文件中，添加或修改以下配置：

{

    "go.alternateTools": {
        "go.buildOnSave": "package",  
        "go.lintOnSave": "workspace", 
        "go.vetOnSave": "workspace",  
        "go.buildFlags": [],
        "go.lintFlags": [],
        "go.vetFlags": [],
        "go.coverOnSave": false,
        "go.useCodeSnippetsOnFunctionSuggest": false,
        "go.formatOnSave": true,
        "go.formatTool": "goreturns", // goimports
        "go.lintTool": "golangci-lint",
        "go.useLanguageServer": false,  // 如果useLanguageServer设为true，那么在编写代码时引入本地没有的package时，会自动下载安装 就是有时候会非常卡，保存go的编码文件时偶尔会卡死。这点你们自己取舍吧

        "go.goroot": "", // 你的 Goroot, 可选配置
        "go.gopath": "", // 你的 Gopath, go1.12 之后改用 go - mod, 可选配置

        "editor.wordWrap": "on",
        "editor.minimap.renderCharacters": false,
        "editor.minimap.enabled": false,
        "terminal.external.osxExec": "iTerm.app",
        "go.docsTool": "gogetdoc",
        "go.testFlags": ["-v","-count=1"],
        "go.buildTags": "",
        "go.gocodeAutoBuild": false,
        "go.autocompleteUnimportedPackages": true,
        "window.zoomLevel": 0,
        "debug.console.fontSize": 16,
        "debug.console.lineHeight": 30
    }

}

配置完成后，保存文件。

二、Linux 系统

（一）安装 Go

对于 Debian 或 Ubuntu 系统，可以使用以下命令安装：
```
sudo apt-get update
sudo apt-get install golang-go
```
对于 CentOS 系统，可以使用以下命令安装：
- 首先安装依赖：
```
sudo yum install -y gcc glibc glibc-devel libstdc++ libstdc++-devel
```
- 然后下载 Go 安装包，从官方网站获取最新的安装包链接，例如：
```
wget https://golang.org/dl/go1.19.3.linux-amd64.tar.gz
```
- 解压安装包到/usr/local ：
```
sudo tar -C /usr/local -xzf go1.19.3.linux-amd64.tar.gz
```
- 配置环境变量，编辑~/.bashrc 文件，添加以下内容：
  export PATH=$PATH:/usr/local/go/bin
- 使配置生效：source ~/.bashrc

（二）设置环境变量

1. 设置 GOPROXY：

打开终端，执行以下命令设置代理：

go env -w GOPROXY=``https://goproxy.cn``,direct
go env -w GOPROXY=``https://mirrors.aliyun.com/goproxy/

2. 修改 GOPATH：

编辑~/.bashrc 文件，添加以下内容设置 GOPATH，例如设置为~/mygo ：

cat >> ~/.bashrc << EOF
export GOPATH=~/mygo
export PATH=$PATH:$GOPATH/bin
EOF

使配置生效：source ~/.bashrc

三、macOS 系统

（一）安装 Go

前往 Go 语言官方网站（https://golang.org/d l/ ）下载适用于 macOS 的安装包。

下载完成后，双击安装包进行安装，默认安装路径为/usr/local/go 。

（二）设置环境变量

1. 设置 GOPROXY：

打开终端，执行以下命令设置代理：

go env -w GOPROXY=https://goproxy.cn,direct
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/

2. 修改 GOPATH：

编辑~/.zshrc 或~/.bashrc 文件（根据你使用的终端类型），添加以下内容设置 GOPATH，例如设置为~/mygo ：
```
cat >> ~/.bashrc << EOF
export GOPATH=~/mygo
export PATH=$PATH:$GOPATH/bin
EOF
```
使配置生效：source ~/.zshrc 或source ~/.bashrc