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

ビルド制約

ビルド制約 (ビルドタグとも呼ばれる) は、パッケージにファイルが含まれる条件を概説する行コメントです。これらのタグは、オペレーティングシステム、アーキテクチャ、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 version を実行したときに表示されるバージョンと同じです。
コンパイラー		ランタイムで使用可能なものに基づいて、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 モジュールキャッシュを使用します。