ビルド制約とベンダリング

ビルド制約

ビルド制約 (ビルドタグとも呼ばれる) は、パッケージにファイルが含まれる条件を概説する行コメントです。 これらのタグは、オペレーティングシステム、アーキテクチャ、Go バージョン、コンパイラー、cgo サポート、その他のターゲットシステムのニーズなどの要件を指定できます。 以下の例では、このファイルが次の基準を満たすターゲットシステム用であることを宣言しています。

• //+build darwin,cgo linux はビルドタグの古い構文で、Go ではまだ認識されています。 次の 2 つの条件セットを指定します。

  • 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 のビルドに含める必要があります。

GoLand は、これらの制約を使用して、検証、解決、シンボル候補の際に無視すべきファイルを判断できます。 ファイルがターゲットシステムの要件を満たさない場合、GoLand が通知を表示します。 例: スクリーンショット上の次の条件は、 「プロジェクトのビルド制約を構成する」手順の設定と競合します。

ビルドタグフィールドの説明

ビルドタグまたは制約の詳細については、 pkg.go.dev でのビルド制約(英語)を参照してください。

フィールド	ビルドタグ	説明
オペレーティングシステム	GOOS	linux や windows など、コードをコンパイルするオペレーティングシステムを指定します。
アーキテクチャー	GOARCH	amd64 や arm など、コードの CPU アーキテクチャを定義します。
Go バージョン	GOVERSION	インストールされている Go のバージョンを示します。 これは、 go バージョン を実行したときに表示されるバージョンと同じです。
コンパイラー		ランタイムで使用可能なものに基づいて、 gccgo や gc などのコンパイラーを選択します。
CGO サポート	CGO_ENABLED	cgo が有効 (1) か無効 (0) かを示し、C コードを含めることができるかどうかに影響します。
カスタムタグ		//go:build コメント行によって導入されたビルドタグ。 例: 次のスクリーンショットでは、 goexperiment.rangefunc ビルドタグによって、 実験に移動(英語)の関数の反復処理が可能になります。
実験	GOEXPERIMENT	オンまたはオフにできる Go ツールチェーン実験のリスト。 主に Go 自体に取り組んでいる開発者向けです。

ベンダリング

ベンダリングモードを有効にして、プロジェクト内の vendor ディレクトリに格納されている依存関係パッケージのみを使用してアプリケーションを構築します。 このモードでは、Go コマンドは go.mod の依存関係の説明を無視し、 vendor ディレクトリに依存関係の正しいコピーがあると見なします。 デフォルトでは、Go モジュールを使用すると、 vendor ディレクトリはビルド中に無視されます。

Go 1.14 RC では、自動ベンダリングモードが Go の組み込み機能になりました。 Go 1.14 RC 以降、GoLand でもデフォルトで自動ベンダリングモードが有効化されます。 たとえば、別の言語で使用されている vendor フォルダーを含むモノリポジトリがある場合、プロジェクトごとにベンダリングを無効にすることができます。

ベンダリングサポートを自動的に有効にする チェックボックスを使用して自動ベンダリングを制御できます。 チェックボックスを選択すると、自動ベンダリングが有効になります。 vendor ディレクトリをモジュールに追加すると、IDE はそれを使用します。 ディレクトリを削除すると、GoLand はグローバル Go モジュールキャッシングを使用します。