# GOROOT 和 GOPATH

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **TL;DR**
> 要配置您的 Go 环境，请打开设置（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），并展开   Go   节点。
>
>
>
> 您可以直接从 IDE [下载 Go SDK](#download-go-sdk)，并为您的项目配置   GOROOT   和   GOPATH  。
>
>
>
> 如有需要，请为不同范围使用单独的   GOPATH   配置。

Go 工具要求您的源代码具有特定结构。 该结构由两个环境变量定义：   GOROOT   和   GOPATH  。 理解并正确配置这些变量可确保您的 Go 项目能够正确编译并运行。

GOROOT   变量指定您的 Go SDK 的位置。 通常，IntelliJ IDEA 会自动设置该值，因此除非想使用不同的 Go 版本，否则无需更改。

GOPATH   变量定义 Go 项目的工作区。 默认情况下，其位置在类 Unix 系统上为  `$HOME/go` ，在 Windows 上为  `%USERPROFILE%\go` 。 它作为已安装二进制文件、缓存模块和校验和数据的根目录。

* 二进制文件由 `go install` 安装到 `$GOBIN` （默认： `$GOPATH/bin` ）。

* 模块由 `go get` 缓存到 `$GOMODCACHE` （默认： `$GOPATH/pkg/mod` ）。

* 校验和数据库状态存储在 `$GOPATH/pkg/sumdb` 。

有关详细信息，请参阅 [go 命令文档的 GOPATH 部分](https://pkg.go.dev/cmd/go#hdr-GOPATH_environment_variable)。

> **Note:**
> 传统的 GOPATH 开发模式（早于 Go 模块）现已弃用。 此前，GOPATH 定义了二进制文件、已编译包和源文件的存储位置。 有关更多信息，请参阅 [go.dev 上的 GOPATH 开发模式](https://go.dev/wiki/GOPATH#gopath-development-mode)。

以下视频演示如何在 IntelliJ IDEA 中将 Go SDK 更改为较新版本。

## GOROOT

GOROOT   设置定义 IntelliJ IDEA 为您的项目使用哪个 Go SDK 版本。 您可以直接从 IDE 下载新版本，或配置本地安装。

Procedure: 配置 GOROOT

* 打开设置 ( `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)))，导航至  `语言与框架 | Go | GOROOT` 。

从列表中选择 Go 版本。 如果没有可用版本，请点击   添加 SDK   以 [下载 Go 版本](#download-go-sdk) 或 [选择本地 Go SDK 安装](#navigate-to-go-sdk)。

Procedure: 选择本地 Go SDK

请确保所选文件夹同时包含  `bin`  和  `src`  目录。

1. 打开设置（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），然后转到  `语言与框架 | Go | GOROOT` 。

2. 点击   添加 SDK   按钮（ ![添加 SDK 按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)），然后选择   本地  。

3. 在文件浏览器中，导航到您系统上的 Go SDK 文件夹。

4. 点击   打开   进行确认。

![选择本地副本的 Go SDK](https://resources.jetbrains.com/help/img/idea/2026.3/go_ij_select_go_version.png)

Procedure: 下载 Go SDK

1. 打开设置 ( `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)))，导航至  `语言与框架 | Go | GOROOT` 。

2. 请点击   添加 SDK  按钮( ![添加 SDK 图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg))并选择   下载…  。

3. 在列表中选择所需的 Go SDK 版本。

4. 在   位置   字段中，指定 SDK 的安装位置。 要浏览并选择位置，请点击   浏览   图标（ ![浏览图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.menu-open_dark.svg)）。

5. 点击   OK   以确认下载和安装设置。

在设置对话框中点击   应用   或   OK   时，IntelliJ IDEA 会自动下载并解压所选 Go SDK。

![下载 Go SDK](https://resources.jetbrains.com/help/img/idea/2026.3/go_ij_download_go_sdk_settings.png)

### 使用 asdf

您可以使用   asdf   来管理项目的多个 Go 版本。 IntelliJ IDEA 可识别通过   asdf   安装并管理的 Go SDK，从而允许您在 IDE 中直接在它们之间切换。

> **Note:**
> 要将   asdf   用作 Go SDK 管理工具，请确保已安装 [asdf](https://asdf-vm.com/guide/getting-started.html#_3-install-asdf)，并通过 [asdf 安装指南](https://asdf-vm.com/guide/getting-started.html#_5-install-a-version) 安装所需的 Go 版本。

asdf   是一个可管理多种编程语言和实用工具的版本管理器。 它允许您在全局或按项目目录定义不同的 Go 版本：

* `asdf global` ：为整个系统设置默认的 Go 版本。

* `asdf local` ：为特定项目或目录设置 Go 版本。

IntelliJ IDEA 同时支持  `asdf local`  和  `asdf global`  配置。 您也可以指定多个版本，例如：  `asdf local golang 1.21.0 1.20.8` 。 IDE 会自动检测已配置的版本，并在 Go SDK 列表中显示它们。

Procedure: 为项目选择由 asdf 管理的 Go 版本

1. 打开设置 ( `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)))，导航至  `Go | GOROOT` 。

2. 在可用 SDK 列表中，选择由   asdf   管理的 Go 版本。 如果已安装并配置   asdf  ，其提供的各版本会自动显示。

选择版本后，IntelliJ IDEA 将使用相应的 Go SDK 来构建、运行和测试您的项目。 您可以随时在同一设置页面更改版本，或在项目目录中更新您的  `.tool-versions`  文件。

## GOPATH

GOPATH   变量定义用于存储您的 Go 项目、已下载模块和已安装二进制文件的工作区。 您可以根据您的工作流程，将其配置为全局，或按项目与模块进行配置。

在 IntelliJ IDEA 中，   GOPATH   可在不同范围进行设置，从而为不同项目或 SDK 版本隔离环境。

### 为不同范围配置 GOPATH

您可以为以下范围之一配置   GOPATH  ：

> **Note:**
> 如果您配置了多个范围，IntelliJ IDEA 将使用最具体的一个（例如，模块级设置会覆盖项目级或全局设置）。

IDE 会在 Unix 系统上自动将默认的   GOPATH   设置为  `$HOME/go` ，在 Windows 上设置为  `%USERPROFILE%\go` 。 您可以按照下文所述在设置中更改它。

Procedure: 配置 GOPATH

1. 打开设置 ( `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)))，导航至  `Go | GOPATH` 。

2. 选择您要配置的范围：

* 全局 GOPATH ：适用于当前 IntelliJ IDEA 安装中的所有项目。

* 项目 GOPATH ：仅适用于当前项目。

* 模块 GOPATH ：适用于特定模块。 每个模块都可以使用不同的 SDK 或框架配置。

3. 点击   添加  （ !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)）以添加新路径。

4. 在文件浏览器中，选择要与   GOPATH   关联的目录。 所选路径将用于存储已下载的模块、二进制文件和缓存。

![为不同范围配置 GOPATH](https://resources.jetbrains.com/help/img/idea/2026.3/go_configure_gopath.png)

当您应用更改时，IntelliJ IDEA 会自动更新 Go 环境。 新路径会体现在项目配置中，并由 Go 工具用于导入、构建和依赖项管理。

