クイックスタートガイド

このクイックスタートガイドでは、主要な概念を紹介し、GoLand での最初のステップを支援します。

ステップ 1. GoLand で Go プロジェクトを開くか作成する

GoLand をインストールして初めて起動した後は、プロジェクトを作成する必要があります。GoLand ですることはすべて、プロジェクトのコンテキスト内で行われます。これは、コーディング支援、一括リファクタリング、コーディングスタイルの一貫性、その他の機能の基盤として機能します。

IDE 内のプロジェクトで作業を開始するには、次の 3 つのオプションがあります。

既存プロジェクトを開く
バージョン管理システムからプロジェクトをチェックアウトする (VCS)
新規プロジェクトを作成する

既存プロジェクトを開く

GoLand へようこそダイアログで、オープンをクリックします。
または、ファイル | オープンをクリックします。
ファイルブラウザーで、プロジェクトファイルのあるフォルダーに移動し、オープンをクリックします。

プロジェクトを開いたら、Go SDK の場所を指定する必要があります。SDK へのローカルパスを指定するか、ダウンロードできます。Go SDK を設定するには、設定 Ctrl+Alt+S を開き、Go | GOROOT に移動します。SDK の追加ボタンをクリックして、2 つのオプションから選択します。

SDK の追加 : ローカルの SDK コピーを使用してください。ファイルブラウザーで、ハードドライブにある SDK のバージョンに移動します。
ダウンロード : SDK をダウンロードします。ロケーションフィールドで、SDK のパスを指定します。ファイルブラウザーを使用するには、参照アイコンをクリックします。OK をクリックします。

OK をクリックします。

バージョン管理システムから既存のプロジェクトを複製する

GoLand へようこそダイアログで、バージョン管理から取得をクリックします。
バージョン管理リストから、Git または Mercurial を選択します。
- GitHub からファイルをチェックアウトするには、GitHub を選択し、GitHub でログインをクリックします。GitHub で承認するをクリックする必要がある account.jetbrains.com(英語) にリダイレクトされます。GitHub のクレデンシャルを入力し、GitHub アカウントへのアクセスを許可します。
- Mercurial からファイルをチェックアウトするには、Mercurial をインストールして構成し、GoLand を再始動します。ソースへのパスを入力し、リポジトリをコンピューターに複製します。
プロジェクトを開いたら、Go SDK の場所を指定する必要があります。SDK へのローカルパスを指定するか、ダウンロードできます。Go SDK を設定するには、設定 Ctrl+Alt+S を開き、Go | GOROOT に移動します。SDK の追加ボタンをクリックして、2 つのオプションから選択します。
- SDK の追加 : ローカルの SDK コピーを使用してください。ファイルブラウザーで、ハードドライブにある SDK のバージョンに移動します。
- ダウンロード : SDK をダウンロードします。ロケーションフィールドで、SDK のパスを指定します。ファイルブラウザーを使用するには、参照アイコンをクリックします。OK をクリックします。
バージョン管理システムの詳細については、「バージョン管理」を参照してください。

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

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

Go ファイルを作成する

新しいプロジェクトには Go ファイルがありません。Go ファイルを作成するには、次の操作のいずれかを実行します。
- プロジェクトツールウィンドウで、プロジェクトの親フォルダーを右クリックし、新規 | Go ファイルを選択します。
- プロジェクトの親フォルダーをクリックして Alt+Insert を押し、Go ファイルを選択します。
- プロジェクトの親フォルダーをクリックし、ファイル | 新規 | Go ファイルに移動します。
新規 Go ファイルダイアログで、ファイルの名前を入力し、空の Go ファイル（空のファイル）を作成するか、定義済みの main 関数（シンプルアプリケーション）を使用して Go ファイルを作成するかを選択します。

ステップ 2. ユーザーインターフェースを調べる

初めて GoLand を起動すると、GoLand へようこそダイアログが表示されます。GoLand へようこそダイアログから、プロジェクトを作成して開いたり、バージョン管理システムからプロジェクトをチェックアウトしたり、ドキュメントを表示したり、IDE を設定したりできます。

プロジェクトを開くと、メインウィンドウがいくつかの論理領域に分割されています。

左側にあるプロジェクトツールウィンドウに、プロジェクトファイルが表示されます。ツールウィンドウは、プロジェクト管理、検索、実行およびデバッグ、バージョン管理システムとの統合、その他のタスクへのアクセスを提供するウィンドウです。すべてのツールウィンドウのリストを見るには、表示 | ツールウィンドウに移動してください。
エディターペインは右側にあり、そこでコードを記述します。開いているファイル間を簡単に移動するためのタブがあります。
ナビゲーションバーはエディターの上にあり、これを使用すると、アプリケーションをすばやく実行してデバッグしたり、基本的な VCS アクションを実行したりすることもできます。
ガターはエディターの横にある縦縞です。ブレークポイントが表示され、定義や宣言に移動するのに便利な方法が提供されています。また、アプリケーションを実行アイコン（）を使用してアプリケーションを実行またはデバッグすることもできます。
エディターの右側にあるスクロールバー。GoLand はコードの品質を監視し、コードインスペクションの結果（エラー、警告、タイプミス、その他の問題）を表示します。ガターの上部にあるインジケーターは、ファイル全体のコードインスペクションの全体的なステータスを示します。
ステータスバーは、プロジェクトと IDE 全体のステータスを示し、ファイルエンコーディング、改行コード、インスペクションプロファイル、その他の警告および情報メッセージに関する情報を示します。

IDE の左下部分の状況バーに、またはボタンが表示されます。これらのボタンは、ツールウィンドウのポップアップの表示を切り替えます。このボタンの上にマウスを置くと、現在使用可能なツールウィンドウのリストが表示されます。

ステップ 3. コードを書く

エディターで作業している間、GoLand はあなたのコードを分析し、それを最適化する方法を探り、潜在的および実際の問題を検出します。次のリストには、コード作成に役立ち、生産性を向上させるのに役立つ可能性のある基本的な機能とツールが含まれています。

リファクタリング
コード補完
コードを生成
ライブテンプレート
インスペクション
インテンションアクション

リファクタリング

リファクタリング(英語)は、新しい機能を作成せずにソースコードを改善するプロセスです。リファクタリングは、コードを安定させ、dry(英語) に保ち、保守を容易にできます。

GoLand は、次のリファクタリングオプションを提案します。

シグネチャーの変更はメソッドまたは関数名を変更します。パラメーターを追加、削除、並べ替えます。新しい非可変パラメーターにデフォルト値を割り当てます。
抽出リファクタリングは、グループ化できるコードフラグメントを抽出します。定数、変数、メソッド、インターフェースを抽出できます。
インライン化リファクタリングは、抽出されたコードフラグメントを呼び出し元コードに移動します。抽出リファクタリングの反対。
コピーリファクタリングは、ファイル、ディレクトリ、パッケージを別のディレクトリまたはパッケージにコピーします。
移動リファクタリングは、ソースコードセクションを別のパッケージまたはファイルに移動します。例: 移動リファクタリングを使用して、メソッドを別のパッケージに移動できます。

コード補完

GoLand には 2 種類のコード補完があります。

基本的なコード補完 Ctrl+Space は、可視性スコープ内のタイプ、インターフェース、メソッド、キーワードの名前を完成させるのに役立ちます。コード補完を呼び出すと、GoLand はコンテキストを分析し、現在のキャレット位置から到達可能な選択肢を提案します。デフォルトでは、GoLand は、入力時にコード補完ポップアップを自動的に表示します。
スマートコード補完 Ctrl+Shift+Space は、候補リストをフィルタリングし、現在のコンテキストに該当するタイプのみを表示します。
次のアニメーションは、基本的な型一致の補完とスマートな型一致の補完の違いを示しています。さまざまな補完タイプに対して提案されているバリアントの数に注意してください

コードを生成

GoLand は、一般的なコード構造と繰り返し要素を生成する複数の方法を提供し、生産性の向上に役立ちます。これらは、新しいファイルを作成するときに使用されるファイルテンプレート、コンテキスト、さまざまなラッパー、文字の自動ペアリングに基づいて異なる方法で適用されるカスタムまたは事前定義されたライブテンプレートのいずれかです。

getter、setter、コンストラクター、欠落しているメソッド、テストファイルを生成できます。生成アクションの詳細については、「生成アクションの使用」を参照してください。

ライブテンプレート

ライブテンプレートを使用して、ループ、条件、宣言、print ステートメントなどの一般的な構造をコードに挿入します。

コードスニペットを展開するには、対応するテンプレートの省略形を入力して Tab を押します。Tab を押し続けると、テンプレート内の 1 つの変数から次の変数に移動します。Shift+Tab を押して、前の変数に移動します。

ライブテンプレートのリストを表示するには、設定 Ctrl+Alt+S を開き、エディター | ライブテンプレートに移動します。
ライブテンプレートを使用してコード化されている Hello World プログラムの次の例を検討してください。

インスペクション

GoLand には、プロジェクトをコンパイルする前に、プロジェクト内の異常なコードを検出して修正する一連のコードインスペクションがあります。IDE は、さまざまな問題を見つけてハイライトし、デッドコードを見つけ、考えられるバグやスペルの問題を見つけ、全体的なコード構造を改善することができます。

インスペクションは、すべてのプロジェクトファイルまたは特定のスコープでのみ（たとえば、本番コードまたは変更されたファイルでのみ）コードをスキャンできます。

すべてのインスペクションには、問題がコードに影響を与える可能性がある程度の重大度レベルがあります。重大度はエディター内で異なる方法でハイライトされるため、重大な問題と重要性の低いものとをすばやく区別できます。GoLand には事前定義された重大度のセットが付属しており、独自のものを作成できます。

インスペクションのリストを表示するには、設定 Ctrl+Alt+S を開き、エディター | インスペクションに移動します。それらの一部を無効にするか、他を有効にし、さらに各インスペクションの重大度を調整します。エラーと見なすか、単なる警告と見なすかを決定します。
例: 到達不能コードインスペクションは実行できないコード部分を検出します。

インテンションアクション

エディターで作業している間、GoLand はあなたのコードを分析し、それを最適化する方法を探り、潜在的かつ実際の問題を検出します。インテンションのアクションは、エラーや警告から最適化の提案まで、幅広い状況をカバーします。

GoLand では、次の種類のインテンションアクションを使用できます。

インテンションアクション : コードの一部を生成するか、コードの代替バリアントを提案するアクション。通常、インテンションアクションは有効なコードに適用されます。黄色のバルブアイコンをクリックすると、現在のコンテキストで使用可能なインテンションアクションを表示できます。例: 構造体型の値を生成するコンストラクターを作成できます。または、if-else ステートメントを同等のステートメントで置き換えますが、条件を否定し、if-else ブランチを交換します。
クイックフィックス : コードの問題の解決策を提案するアクション。通常、インテンションアクションはエラーのあるコードに適用されます。例: 式の最後で括弧を見逃したとき。または、値を特定の型に変換するのを忘れたとき。

インテンションアクションのリストを表示するには、設定 Ctrl+Alt+S を開き、エディター | インテンションに移動します。

インテンションアクションを適用するには、バルブアイコンをクリックして（または Alt+Enter キーを押して）候補のリストを開きます。
リストからアクションを選択し、Enter を押します。
例: インテンションアクションを使用して、コードに別の言語を挿入することができます。

ステップ 4. コードを実行してデバッグする

GoLand のコードは、キーボードから、コンテキストメニューから、ガターメニューから、実行 / デバッグ構成を使用して実行およびデバッグできます。

アプリケーション Shift+F10 を実行するには、ガターのアプリケーションを実行アイコンをクリックして、<application_name> を実行しますを選択します。

コードをデバッグする

デバッグは、プログラムデータを探索できるように、プログラムの実行が一時停止されるブレークポイントを配置することから始まります。ブレークポイントを配置するガターの線をクリックするだけです。

アプリケーション Shift+F9 をデバッグするには、ガターのアプリケーションを実行アイコンをクリックして、<application_name> をデバッグしますを選択します。次に、プログラムの実行を段階的に実行します（実行メニューまたはデバッグツールウィンドウで使用可能なオプションを参照してください）。
詳細は、デバッグを参照してください。