# Go (GOPATH)

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

如果不需要复杂的依赖管理，并且准备好将所有项目文件存储在  `GOPATH`  下，您可能需要创建这种类型的项目。

## 创建一个 GOPATH 项目

默认情况下，IntelliJ IDEA 会创建一个带有 Go modules 集成的项目。 您可以在设置中禁用此选项。 但请确保保留必要的文件结构，并将您的项目存储在 GOPATH 下。 有关将代码存储在 GOPATH 下的详细信息，请参考 [go.dev 上的如何编写 Go 代码（使用 GOPATH）](https://go.dev/doc/gopath_code)。

首先，您需要创建一个带有 Go modules 集成的默认 Go 项目，但请确保将您的项目放置在 GOPATH 下。

Procedure: 创建 Go 项目

1. 选择  `文件 | 新建 | {0, choice, 0#新建|1#}{1, choice, 0#Java |1#}项目…` 。

或者，在   欢迎来到 %instance%   对话框中，转到   新建 | 项目  。

2. 在   新建项目   对话框中，从可用项目类型列表中选择   新建项目  。

确保在   语言   列表中选择 Go 作为项目语言。

3. 在   GOROOT   字段中，指定 Go 安装位置。 IntelliJ IDEA 通常会自动检测到此位置。

要更改或安装新的 Go SDK 版本，请点击   添加 SDK  （ ![添加 SDK 图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.add.svg)），然后选择以下选项之一：

* 本地 ：使用本地系统中的现有 SDK。

* 下载 ：从官方存储库下载一个 Go SDK 版本。

4. （可选）选中或清除   自动启用 vendoring 支持   复选框，以启用或禁用 vendoring 支持。

5. （可选）在   环境   字段中，指定项目所需的任何环境变量。 例如，  `GOPROXY` 。

要了解更多信息，请参阅 [环境变量部分](create-a-project-with-go-modules-integration.html#environment-variables)。

> **Note:**
> 请勿使用此字段为  `GOEXPERIMENT`  变量设置标签。 请改用   实验   字段，在   构建标记   设置中进行操作。 有关详细信息，请参阅 [使用 Go 实验](configuring-build-constraints-and-vendoring.html#using_go_experiments)。

6. 点击   创建   创建项目。

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

其次，禁用 Go modules 集成。

Procedure: 禁用 Go modules 集成

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 Go 模块` 。

2. 清除   启用 Go 模块集成   复选框。

![启用 Go 模块集成](https://resources.jetbrains.com/help/img/idea/2026.3/go_enable_go_modules_integration.png)

## 添加并安装依赖项

`GOPATH`  存储代码库和开发所需的所有文件。 其中还包括下载并安装的所有软件包。 禁用 GOPATH 索引时，仅索引项目文件和 vendored 软件包。 这可能会提升性能，但会阻止使用位于 GOPATH 中的软件包。

如果项目具有外部依赖项，请考虑为整个 GOPATH 启用索引。 默认情况下，此选项是禁用的。

![在项目中禁用 Go modules](https://resources.jetbrains.com/help/img/idea/2026.3/go_disable_go_modules_in_a_project.png)

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   复选框。

Procedure: 下载并安装依赖项

1. 点击  `import`  语句中的未解析依赖项，然后按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS))。

2. 从意图操作列表中选择  `go get -t <package>` 。

![下载并安装依赖项](https://resources.jetbrains.com/help/img/idea/2026.3/go_download_and_install_dependencies.png)

## 安装 Go SDK

> **Note:**
> 确保提供的 Go SDK 文件夹路径包含  `bin`  和  `src`  文件夹。

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. 在文件浏览器中，导航到硬盘上的 SDK 版本。

4. 点击   打开  。

![安装 Go SDK](https://resources.jetbrains.com/help/img/idea/2026.3/go_ij_installing_go_sdk.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. 从   版本   列表中选择 SDK 版本。

4. 在   位置   字段中，指定 SDK 的路径。 要使用文件浏览器，请点击   浏览…   图标( ![浏览图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.menu-open_dark.svg))。

5. 点击   OK  。

![安装 Go SDK](https://resources.jetbrains.com/help/img/idea/2026.3/go_ij_downloading_go_sdk.png)

