# 构建约束与供应商管理

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

构建约束和 vendoring 模式是您可以用来微调构建过程的工具。 通过构建约束，您可以定义规则来确定哪些文件包含在包中。 通过启用 vendoring mode，您可以确保您的应用程序仅使用存储在您的项目中的依赖包构建。 这种方法允许您在包中包含特定文件，并使用您已在本地修改或修补过的依赖项。

## 构建约束

构建约束，也称为构建标签，是一行注释，概述了包含文件在包中的条件。 这些标签可以指定操作系统、架构、Go 版本、编译器、cgo 支持或其他目标系统需求等要求。 在以下示例中，我们声明此文件适用于满足以下条件的目标系统：

* `// +build darwin,cgo linux` 是 Go 中仍然被识别的旧语法构建标签。 它规定了两组条件： * `darwin,cgo` ：在为 `darwin` 平台（macOS）编译时，并且启用了 `cgo` 时包括在构建中。 `cgo` 允许在 Go 程序中包含 C 代码。 * `linux` ：编译 Linux 平台时包含。 空格作为 OR 运算符，意味着该文件应包含在启用了 cgo 的 macOS 或 Linux 中。

* `//go:build (darwin && cgo) || linux` 是 Go 1.17 引入的新构建标签语法，采用更明确的布尔表达式格式： * `(darwin && cgo) || linux` ：该文件应包含在启用 cgo 的 macOS 构建中，或在 Linux 中包含，与上述条件相同。

![构建约束](https://resources.jetbrains.com/help/img/idea/2026.3/go_example_build_constraints.png)

IntelliJ IDEA 可以使用这些约束来决定在验证、解析和符号建议期间必须忽略哪些文件。 如果文件不满足目标系统的要求，IntelliJ IDEA 会显示通知。

![有关构建约束的通知](https://resources.jetbrains.com/help/img/idea/2026.3/go_example_build_constraints_invalid.png)

在 Go 1.17 及更高版本中，  `//go:build`  指令需要一个约束，例如  `//go:build linux` 。 如果约束为空，IntelliJ IDEA 会报告错误，并提供一个用于删除该注释的快速修复。 添加约束或移除指令。

空的旧版  `// +build`  指令与  `// +build ignore`  含义相同：除非将  `ignore`  添加到   自定义标签  ，否则会排除该文件。

Procedure: 配置项目的构建约束

Go 中的  `go build`  命令 [支持](https://pkg.go.dev/cmd/go) 通过  `-tags`  参数使用自定义标签，以根据构建约束有条件地编译文件。 这些标签允许您指定在构建过程中包含文件的条件。

在 您 的 Go 源文件中，您可以通过在文件顶部放置包含  `// +build`  或  `//go:build`  指令及自定义标签的注释来定义构建约束。

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｜构建标记` 。

2. 从下拉列表中选择目标系统的预期值。 如果您有任何自定义标签，请在   自定义标签  字段中指定它们（在标签之间使用空格作为分隔符）。

3. 点击   OK  。

![配置项目的构建约束](https://resources.jetbrains.com/help/img/idea/2026.3/go_configure_project_build_contraints.png)

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 | 构建标签` 。

2. 请在其中一个字段中输入 Go 实验的 Type 标签：

* 自定义标签 ：按以下格式输入标记： `goexperiment.rangefunc goexperiment.loopvar` 。 请使用空格将标签彼此分开。

* 实验 ：按以下格式输入标记： `rangefunc, loopvar` 。 使用逗号分隔标签。

标签名称位于相应的软件包内。 例如，访问  `iter` 包时，您会注意到紧随  `go:build` 标签之后的标签名称。 专门针对  `iter`  包，标签是  `goexperiment.rangefunc` 。 在   自定义标签  字段中输入完整标签，而在   实验  字段中仅输入  `goexperiment.` 之后的部分。

### 构建标签字段描述

有关构建标签或约束的更多信息，请参见 [pkg.go.dev 上的构建约束](https://pkg.go.dev/cmd/go#hdr-Build_constraints)。

|  Field  |  值  |  描述  |
| --- | --- | --- |
|  操作系统  |   `linux` ，  `windows`   |  选择目标操作系统。 IDE 将所选值作为  `GOOS`  传递给 Go。  |
|  体系结构  |   `amd64` ，  `arm64`   |  选择目标 CPU 架构。 IDE 将所选值作为  `GOARCH`  传递给 Go。  |
|  Go 版本  |   `go1.N`   |  匹配指定版本及更高版本的 Go 发行版。 例如，  `go1.22`  匹配 Go 1.22 及更高版本。  |
|  编译器  |   `gc` ，  `gccgo`   |  在可用时选择编译器。  |
|  CGO 支持  |   `cgo` ，  `!cgo`   |  匹配 cgo 支持是否已启用。 IDE 将所选设置作为  `CGO_ENABLED`  传递给 Go。  |
|  自定义标签  |  自定义标记名称  |     匹配由  `//go:build`  注释行引入的自定义标记。       例如，  `goexperiment.rangefunc`  构建标记支持对来自 [Go 实验](https://pkg.go.dev/internal/goexperiment) 的函数／方法进行迭代。     |
|  实验  |  实验名称  |  启用或禁用 Go 工具链实验。 IDE 将所选值作为  `GOEXPERIMENT`  传递给 Go。  |

### 使用多个条件进行构建约束

下表比较了在条件使用 AND 和 OR 时旧版和当前的构建约束语法。

|   `// +build`   |   `//go:build`   |
| --- | --- |
|     ``` // +build darwin,cgo linux ```      逗号（作为逻辑与）和空格（作为逻辑或）     |     ``` //go:build (darwin && cgo) \|\| linux ```       `&&`  运算符（逻辑  `And` ）和  `\|\|`  运算符（逻辑  `Or` ）     |

## 供应模式

启用 vendoring 模式后，您只使用存储在项目的  `vendor` 目录下的依赖包来构建应用程序。 在此模式下，Go 命令会忽略  `go.mod`  中的依赖描述，并假设  `vendor`  目录保存着依赖的正确副本。 默认情况下，当您使用 Go modules 时，  `vendor`  目录在构建期间会被忽略。

在 Go 1.14 RC 中，自动 vendoring 模式成为了 Go 的内置功能。 从 Go 1.14 RC 开始，IntelliJ IDEA 默认还启用了自动 vendoring 模式。 您可以为每个项目禁用 vendoring，例如，当您有一个包含另一个语言使用的  `vendor`  文件夹的 monorepo 时。

您可以通过使用   自动启用 vendoring 支持  复选框来控制自动导入功能。 当复选框被选中时，自动引入功能将被启用。 因此，如果您将  `vendor`  目录添加到模块中，IDE 会使用它。 如果您删除该目录，IntelliJ IDEA 将使用全局 Go Modules 缓存。

Procedure: 切换 vendoring 模式

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. 清除或选择   自动启用 vendoring 支持  复选框，然后点击   OK  。

