# Go

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

默认情况下，IntelliJ IDEA 建议创建 Go 模块项目。 使用 Go modules，您不需要将项目文件保存在 GOPATH 下， [可以轻松管理项目中的依赖项](#working-with-dependencies)。 详细了解 Go 模块，请访问 [go.dev](https://go.dev/blog/using-go-modules)。

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` 。

要了解更多信息，请参阅 [环境变量部分](#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 项目更改 IML 文件位置

> **Note:**
> 确保已安装并启用 [Go 插件](https://plugins.jetbrains.com/plugin/9568-go)。

在 IntelliJ IDEA 中创建 Go 项目时，您可以为  `.iml`  文件指定一个目录。 默认情况下，该文件会创建在项目的根目录中。

若要在 IntelliJ IDEA 中更改现有 Go 项目的 IML 文件位置，您需要更新  `modules.xml`  文件（位于  `.idea`  目录中）。

Procedure: 更改现有 Go 项目的 IML 文件位置

1. 在   项目   工具窗口中，打开项目的  `.idea`  文件夹。

2. 在  `modules.xml`  文件中更新  `fileurl`  和  `filepath`  属性，使二者均指向  `.idea/`  内新的 IML 文件位置。

3. 将 IML 文件移动到  `.idea`  目录中。

![更改现有 Go 项目的 IML 文件位置](https://resources.jetbrains.com/help/img/idea/2026.3/go_change_the_iml_file_location_in_modules_xml.png)

## 在项目中使用 Go modules

在   项目   工具窗口中 (  `视图 | 工具窗口 | 项目` )，使用 Go modules 会显示它们的完整导入路径。 每个 Go Module 的版本以暗淡的字体颜色显示，以帮助您区分它们。

![Go Module 以灰色字体显示](https://resources.jetbrains.com/help/img/idea/2026.3/go_module_is_shown_in_a_dimmed_font_color.png)

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 模块集成   复选框。

3. 点击   OK  。

![在项目中启用新项目](https://resources.jetbrains.com/help/img/idea/2026.3/go_ij_enable_go_modules.png)

## 处理依赖关系

默认情况下，IntelliJ IDEA 会在您打开项目或修改  `go.mod`  时下载所有必要的依赖项。 您可以在设置中配置此行为。

Procedure: 禁用 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 | Go Modules` 。

2. 点击   下载 Go 模块依赖项   下拉菜单并选择所需选项。 可以从以下选项中选择：

* 为所有项目启用 ：为所有项目启用 Go 模块依赖项的自动下载。 这是默认设置。 IDE 会在每次执行 `go list -m` 后运行 `go mod download` 。 如果互联网连接受限或希望手动下载依赖项，请禁用此选项。

* 为所有项目禁用 ：为所有项目禁用 Go 模块依赖项的自动下载。

* 为当前项目启用，为其他项目禁用 ：仅为当前项目启用依赖项的自动下载。 新项目将默认使用 为所有项目禁用 。

* 为当前项目禁用，为其他项目启用 ：仅为当前项目禁用依赖项的自动下载。 新项目将默认使用 为所有项目启用 。

![Go 模块的自动下载](https://resources.jetbrains.com/help/img/idea/2026.3/go_automatic_download_of_go_modules.png)

Procedure: 从 go.mod 同步依赖

1. 确保已启用 Go 模块集成。 有关更多信息，请参阅 [在项目中启用 New project](#enable-go-modules-in-a-project)。

2. 在   项目   工具窗口 (  `视图 | 工具窗口 | 项目` )，双击 MOD 文件。

3. 点击依赖声明。

4. 按 `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)) 并选择要执行的操作。 可用选项：

* 修复缺失的依赖项 ：通过调用 `go mod tidy` 或 `go mod vendor` 获取并下载缺失的依赖项，并移除未使用的依赖项。 `替换` 指令中列出的依赖项不会被获取或移除。 `替换` 指令中的未使用依赖项会标记为红色。 这不是错误，也不会影响应用程序行为。

* 将所有模块下载到模块缓存中 ：获取并下载所有缺失的依赖项，并在 项目 工具窗口 ( `视图 | 工具窗口 | 项目` ) 中的 外部库 下显示它们。

* 下载 <module_name> 到模块缓存 ：获取并下载所选模块。 它会显示在 项目 工具窗口 ( `视图 | 工具窗口 | 项目` ) 中的 外部库 下。

![将所有模块下载到模块缓存中](https://resources.jetbrains.com/help/img/idea/2026.3/go_download_all_modules_to_the_module_cache.png)

> **Note:**
> 如果从  `go.mod`  文件中移除某个依赖项，IntelliJ IDEA 会自动将其从可用库列表中移除。

Procedure: 从已打开的 Go 文件同步依赖项

1. 确保已启用 Go 模块集成。 有关更多信息，请参阅 [在项目中启用 New project](#enable-go-modules-in-a-project)。

2. 点击  `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))，然后选择   修复缺失的依赖项  。

![获取依赖项](https://resources.jetbrains.com/help/img/idea/2026.3/go_fetch_dependencies_go_modules.png)

Procedure: 为"go.mod"配置自动运行"go list"

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)) 打开设置，然后转到  `构建、执行、部署 | 构建工具` 。

2. 选择或取消选中   在构建脚本更改后同步项目  选项。

3. 根据工作流，选择以下选项之一：

* 任何更改 ：在对 `go.mod` 进行任何修改后运行 `go list` 。 默认情况下，每当 `go.mod` 更改时，IntelliJ IDEA 都会使用此选项自动运行 `go list` 。

* 外部更改 ：在 IDE 内编辑文件时，禁用 `go list` 的自动执行。 进行更改后，点击 加载 Go modules 变更 图标 ( ![加载 Go 模块更改图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.buildLoadChanges.svg)) 以手动应用并加载更新。 ![加载 Go modules 变更图标](https://resources.jetbrains.com/help/img/idea/2026.3/go_load_go_modules_changes_icon.png)

* 如果不想在对 `go.mod` 进行任何修改后运行 `go list` ，请清除 在构建脚本更改后同步项目 复选框。 禁用此选项后，所有内部和外部更改都会显示 加载 Go modules 变更 图标。

Procedure: 创建依赖关系图

`go.mod`  文件列出了项目中使用的依赖项。 可以使用它生成这些依赖项的可视化图。

1. 确保项目中已启用新项目。

2. 右键点击  `go.mod`  文件并选择  `图表 | 显示图表` 。

![创建依赖关系图](https://resources.jetbrains.com/help/img/idea/2026.3/go_create_a_diagram_of_dependencies.png)

> **Tip:**
> 如需了解有关 vendoring 的更多信息，请参阅 [Vendoring](configuring-build-constraints-and-vendoring.html#vendoring)。

Procedure: 从依赖导入路径导航到包源文件

1. 在   项目   工具窗口 (  `视图 | 工具窗口 | 项目` ) 中，点击  `go.mod`  文件两次以在编辑器中打开。

2. 右键点击依赖项导入路径并选择  `转到 | 声明或用法`  `Ctrl+B` (Windows), `⌘ B` (macOS), `⌘ B` (IntelliJ IDEA Classic (macOS)), `⌘ B` (macOS System Shortcuts), `Ctrl+B` (XWin), `Ctrl+B` (GNOME), `Ctrl+B` (KDE), `Ctrl+Alt+G` (Emacs), `F12` (Sublime Text), `F12` (Sublime Text (macOS)), `F12` (Visual Studio), `F12` (Visual Studio (macOS)), `Ctrl+B` (NetBeans), `F3` (Eclipse), `F3` (Eclipse (macOS))。

![从依赖导入路径导航到包源文件](https://resources.jetbrains.com/help/img/idea/2026.3/go_navigate_to_sources_from_go_mod.png)

### 更新 go.mod 中的依赖项

打开  `go.mod`  文件时，IntelliJ IDEA 会高亮显示过时的依赖项。 可以点击嵌入提示以应用快速修复并更新依赖项。

> **Note:**
> 如果没有看到嵌入提示，请按 `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)) 打开设置并导航到  `编辑器 | 内嵌提示` 。 在   Code Vision片段视觉化工具栏：Code Vision 点击 Code Vision   节点下，确保已选中   更新依赖项   复选框。

还可以一次性更新所有依赖项，可以更新到最新补丁版本，也可以更新到最新可用版本。 如有需要，可以将更新限制为仅直接依赖项。

IntelliJ IDEA 还包含针对已弃用和已撤回版本的检查：

* 已弃用的依赖项 ：标记为删除线文本。 表示该依赖项已弃用。

* 已撤回的依赖项版本 ：也标记为删除线文本。 表示该版本已被撤回。

Procedure: 更新依赖项

* 点击依赖项并按 `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))。

选择相应的意图操作：

* 将 <dependency> 版本更改为 <new_version> ：将所选版本更新到包含已知漏洞修复的最近版本。 这不一定是最新版本。

* 将所有依赖项更新到最新补丁版本 ：将所有存在漏洞的版本更新到其最新补丁版本，该版本包含错误修复和向后兼容的更改。

* 将所有依赖项更新到最新版本 ：将所有存在漏洞的版本更新到最新可用版本。

* 更新直接依赖项到最新补丁版本 ：将所有直接依赖项更新到其最新补丁版本。 直接依赖项是指出现在源文件中 `import` 语句里的模块。

* 更新直接依赖项到最新版本 ：将所有直接依赖项更新到其最新版本。

Procedure: 显示依赖项的漏洞信息

1. 点击依赖项并按 `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. 选择   显示 <dependency> 的漏洞信息  。

Procedure: 自定义检查设置

* 要调整这些检查的作用域或严重性，请打开设置 ( `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 modules` 。

## 环境变量

环境变量提供了一种配置应用程序执行形参的方法。 可用于存储用于下载依赖项的代理服务器地址 (  `GOPROXY` )、定义私有软件包 (  `GOPRIVATE` )，以及设置其他相关值。 在 IntelliJ IDEA 中，您可以使用以下环境变量模板：

* GOPROXY ：指定运行 `go` 命令时用于下载依赖项的代理服务器。

* GOSUMDB ：指定用于验证 `go.sum` 文件中列出的软件包是否可信的校验和数据库。

* GOPRIVATE ：列出被视为私有的模块。 `go` 命令会跳过这些模块的代理和校验和验证。

* GONOPROXY ：列出不应使用代理服务器的私有模块。 此变量会针对代理设置重写 `GOPRIVATE` 。

* GONOSUMDB ：列出跳过校验和验证的私有模块。 此变量会针对校验和设置重写 `GOPRIVATE` 。

* 其他 ：使用此选项定义自定义变量。 例如， `GOMODCACHE` 可用于将默认模块缓存位置从 `$GOPATH/pkg/mod` 更改为自定义路径，如 `$WORK/modcache` 。

> **Tip:**
> 有关环境变量的更多信息，请参阅 [go.dev 上的环境变量](https://go.dev/ref/mod#environment-variables)。

IntelliJ IDEA 还会自动检测与 Go 模块相关的系统环境变量，并在   环境变量   对话框中的   系统环境变量   部分下显示它们。

Procedure: 在项目中引入环境变量

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. 在字段   环境   中，点击字段末尾的   浏览   图标。

3. 在   环境变量   窗口中，点击   添加   按钮 ( !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg))，然后选择要添加的模板。

![在新项目中引入环境变量](https://resources.jetbrains.com/help/img/idea/2026.3/go_introduce_an_environment_variable.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)

