# 设置环境变量

URL: https://caijiao.org/go/01-go-basic/04-env-setup
Source: docs/go/01-go-basic/04-env-setup.md
Description: 本节介绍如何为 Go 语言配置环境变量，包括 GOPATH、GOROOT、PATH 等关键变量，适用于 Windows、Linux 和 macOS 系统。

安装 Go 后，为确保可以在命令行正常使用 Go 命令、构建和运行程序，我们需要正确配置 Go 的环境变量。主要包括 `GOROOT`、`GOPATH` 和 `PATH`。

## 1. 关键环境变量说明

- `GOROOT`：Go 的安装目录，通常不需要手动设置（除非使用非默认路径安装）。
- `GOPATH`：Go 的工作目录，默认是 `$HOME/go`，可自定义。
- `PATH`：需要包含 `$GOROOT/bin` 和 `$GOPATH/bin`，以便系统识别 `go` 命令及工具。


## 2. Windows 配置

1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」；
2. 添加或编辑用户变量：

   - `GOPATH`：如 `C:\Users\YourName\go`
   - 添加到 `Path` 中：
     ```
     C:\Go\bin
     %GOPATH%\bin
     ```

3. 打开命令提示符，执行：

```sh
go env
````

确认环境变量设置成功。

## 3. Linux / macOS 配置

编辑你的 Shell 配置文件，如 `~/.bashrc`、`~/.zshrc`，添加以下内容：

```sh
export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
```

然后执行：

```sh
source ~/.bashrc  # 或 source ~/.zshrc
```

验证配置：

```sh
go env
```

## 4. 示例输出

```txt
GOARCH="amd64"
GOBIN=""
GOCACHE="/home/user/.cache/go-build"
GOPATH="/home/user/go"
GOROOT="/usr/local/go"
GOVERSION="go1.22.x"
```

---

通过正确配置环境变量，你就可以全局运行 `go build`、`go run`、`go install` 等命令，并开始开发 Go 项目了。