Go

デフォルトでは、GoLand は Go モジュールプロジェクトを作成することを提案します。 Go モジュールを使用すると、プロジェクトファイルを GOPATH に保持する必要がなく、プロジェクトの依存関係を簡単に管理できます。 go.dev(英語) で Go モジュールの詳細を参照してください。

Go プロジェクトを作成する

ファイル | 新規 | プロジェクト… を選択します。
または、 {0} へようこそダイアログで新規 | プロジェクトに移動します。
新規プロジェクトダイアログで、使用可能なプロジェクトタイプのリストから Go を選択します。
GOROOT フィールドで、Go のインストール場所を指定します。 GoLand は通常、この場所を自動的に検出します。
Go SDK の新しいバージョンを変更またはインストールするには、 SDK の追加 () をクリックし、次のいずれかのオプションを選択します。
- ローカル: ローカルシステムから既存の SDK を使用します。
- ダウンロード: 公式リポジトリから Go SDK バージョンをダウンロードします。
(オプション) ベンダリングサポートを有効または無効にするには、ベンダリングサポートを自動的に有効にするチェックボックスをオンまたはオフにします。
（オプション）環境フィールドで、プロジェクトに必要な環境変数を指定します。例: GOPROXY。
詳細については、環境変数セクションを参照してください。
GOEXPERIMENT 変数のタグを設定するためにこのフィールドを使用しないでください。代わりに、ビルドタグ設定の実験フィールドを使用してください。詳細については、 Go 実験の使用を参照してください。
「作成」をクリックしてプロジェクトを作成します。

プロジェクトで Go モジュールを使用する

プロジェクトツールウィンドウ（表示 | ツール Windows | プロジェクト）に、Go モジュールが完全なインポートパスとともに表示されます。各 Go モジュールのバージョンは、区別しやすいように淡色表示されています。

プロジェクトで Go モジュールを有効にする

Ctrl+Alt+S を押して設定を開き、 Go | Go モジュールを選択します。
Go モジュールの統合を有効にするチェックボックスを選択します。
OK をクリックしてください。

依存関係の操作

デフォルトでは、プロジェクトを開くか go.mod を変更すると、GoLand は必要な依存関係をすべてダウンロードします。この動作は設定で構成できます。

Go モジュールの依存関係の自動ダウンロードを無効にする

Ctrl+Alt+S を押して設定を開き、 Go | Go モジュールに移動します。
Go モジュールの依存関係をダウンロードするドロップダウンをクリックし、必要なオプションを選択します。以下から選択できます。
- すべてのプロジェクトで有効化: すべてのプロジェクトで Go モジュールの依存関係を自動ダウンロードします。これはデフォルト設定です。 IDE は go list -m の実行後に go mod download を実行します。インターネット接続が制限されている場合、または依存関係を手動でダウンロードしたい場合は、このオプションを無効にしてください。
- すべてのプロジェクトで無効化: すべてのプロジェクトの Go モジュール依存関係の自動ダウンロードを無効にします。
- 現在のプロジェクトでは有効化、他のプロジェクトでは無効化: 現在のプロジェクトのみの依存関係の自動ダウンロードを有効にします。新しいプロジェクトではデフォルトですべてのプロジェクトで無効化が使用されます。
- 現在のプロジェクトでは無効化、他のプロジェクトでは有効化: 現在のプロジェクトのみ依存関係の自動ダウンロードを無効にします。新しいプロジェクトではデフォルトですべてのプロジェクトで有効化が使用されます。

go.mod からの依存関係を同期する

Go モジュール統合が有効になっていることを確認してください。詳細については、プロジェクトで Go を有効にするを参照してください。
プロジェクトツールウィンドウ（表示 | ツール Windows | プロジェクト）で、MOD ファイルをダブルクリックします。
依存関係の宣言をクリックします。
Alt+Enter を押して、実行したいアクションを選択します。利用可能なオプション:
- 不足している依存関係を修正する: 不足している依存関係を取得・ダウンロードし、 go mod tidy または go mod vendor を呼び出して未使用の依存関係を削除します。 置換 ディレクティブにリストされている依存関係は取得も削除もされません。 置換 ディレクティブ内の未使用の依存関係は赤でマークされます。これはエラーではなく、アプリケーションの動作に影響を与えません。
- すべてのモジュールをモジュールキャッシュにダウンロードします: 不足している依存関係をすべて取得してダウンロードし、プロジェクトツールウィンドウ (表示 | ツール Windows | プロジェクト) の外部ライブラリに表示します。
- <module_name> をモジュールキャッシングにダウンロードする。: 選択したモジュールを取得してダウンロードします。プロジェクトツールウィンドウ（表示 | ツール Windows | プロジェクト）の外部ライブラリに表示されます。

開いた Go ファイルからの依存関係を同期する

Go モジュール統合が有効になっていることを確認してください。詳細については、プロジェクトで Go を有効にするを参照してください。
インポート セクションで依存関係をクリックし、 Alt+Enter を押して、不足している依存関係を修正するを選択します。

'go.mod' の 'golist' の自動実行を構成する

Ctrl+Alt+S を押して設定を開き、ビルド、実行、デプロイ | ビルドツールに移動します。
ビルドスクリプトの変更後にプロジェクトを同期する。オプションを選択またはクリアします。
ワークフローに応じて、次のいずれかのオプションを選択します。
- 任意の変更: go.mod に変更があった場合は、 go list を実行します。デフォルトでは、GoLand はこのオプションを使用して、 go.mod が変更されるたびに自動的に go list を実行します。
- 外部の変更: IDE 内でファイルを編集する際、 go list の自動実行を無効にします。変更を加えた後、 Go モジュールの変更をロードするアイコン（）をクリックして、更新を手動で適用して読み込みます。
- go.mod を変更した後に go list を実行したくない場合は、ビルドスクリプトの変更後にプロジェクトを同期する。チェックボックスをオフにします。
  このオプションを無効にすると、内部と外部の両方のすべての変更に対して Go モジュールの変更をロードするアイコンが表示されます。

依存関係のダイアグラムを作成する

go.mod ファイルには、プロジェクトで使用される依存関係がリストされています。このファイルを使用して、これらの依存関係を視覚的に表すダイアグラムを生成できます。

プロジェクトで Go が有効になっていることを確認してください。
go.mod ファイルを右クリックして、ダイアグラム | ダイアグラムの表示を選択します。

依存関係インポートパスからパッケージソースファイルに移動する

プロジェクトツールウィンドウ (表示 | ツール Windows | プロジェクト) で、 go.mod ファイルをダブルクリックしてエディターで開きます。
依存関係のインポートパスを右クリックし、移動 | 宣言または使用箇所 Ctrl+B を選択します。

go.mod の依存関係を更新する

go.mod ファイルを開くと、GoLand は古い依存関係をハイライト表示します。インレイヒントをクリックすると、クイックフィックスを適用して依存関係を更新できます。

すべての依存関係を一度に最新のパッチバージョンまたは利用可能な最新バージョンに更新することもできます。必要に応じて、更新を直接の依存関係のみに制限することもできます。

GoLand には、非推奨および撤回されたバージョンのインスペクションも含まれています：

非推奨の依存関係: 取り消し線でマークされています。依存関係が非推奨であることを示します。
撤回された依存関係バージョン: 取り消し線でマークされています。このバージョンは撤回されたことを示します。

依存関係の更新

依存関係をクリックし、 Alt+Enter を押します。
適切なインテンションアクションを選択します。
- <dependency> バージョンを <new_version> に変更する。: 選択したバージョンを、既知の脆弱性に対する修正を含む最も近いバージョンに更新します。これは必ずしも最新バージョンであるとは限りません。
- すべての依存関係を最新のパッチバージョンに更新する: 脆弱性のあるすべてのバージョンを、バグ修正と下位互換性のある変更を含む最新のパッチバージョンに更新します。
- すべての依存関係を最新バージョンに更新する: 脆弱なバージョンをすべて、利用可能な最新バージョンに更新します。
- 直接の依存関係を最新のパッチバージョンに更新する: すべての直接依存関係を最新のパッチバージョンに更新します。直接依存関係とは、ソースファイル内の インポート 文に記述されているモジュールのことです。
- 直接の依存関係を最新バージョンに更新する: すべての直接依存関係を最新バージョンに更新します。

依存関係に関する脆弱性情報を表示する

依存関係をクリックし、 Alt+Enter を押します。
<dependency> の脆弱性情報を表示する。を選択します。

インスペクション設定をカスタマイズする

これらのインスペクションの範囲または重大度を調整するには、設定 (Ctrl+Alt+S) を開いてエディター | インスペクション | Go モジュールに移動します。

環境変数

環境変数は、アプリケーションの実行パラメーターを設定する手段を提供します。環境変数は、依存関係のダウンロードに使用するプロキシサーバーのアドレス（GOPROXY ）を保存したり、プライベートパッケージ（GOPRIVATE ）を定義したり、その他の関連する値を設定したりするために使用できます。 GoLand では、以下の環境変数テンプレートを使用できます：

GOPROXY: go コマンドを実行するときに依存関係をダウンロードするために使用されるプロキシサーバーを指定します。
GOSUMDB: go.sum ファイルにリストされているパッケージが信頼できるかどうかを確認するために使用されるチェックサムデータベースを指定します。
GOPRIVATE: プライベートとみなされるモジュールをリストします。 go コマンドは、これらのモジュールのプロキシ検証とチェックサム検証をスキップします。
GONOPROXY: プロキシサーバーを使用しないプライベートモジュールをリストします。この変数はプロキシ設定の GOPRIVATE をオーバーライドします。
GONOSUMDB: チェックサム検証を省略するプライベートモジュールをリストします。この変数はチェックサム設定の GOPRIVATE をオーバーライドします。
その他: このオプションを使用してカスタム変数を定義します。例: GOMODCACHE を使用すると、デフォルトのモジュールキャッシュの場所を $GOPATH/pkg/mod から $WORK/modcache などのカスタムパスに変更できます。