GoLand 2026.3 Help

WSL

WSL (WSL 2) – Windows Subsystem for Linux – は、Windows 10 以降で Linux バイナリ実行ファイルをネイティブに実行するための互換性レイヤーです。 現在、Ubuntu、OpenSUSE、SLES など、いくつかの Linux ディストリビューション(英語)をサポートしています。

WSL を設定する

  1. Windows マシンの Microsoft Storeから WSL ディストリビューション(例:Ubuntu)をダウンロードしてインストールします。

    この手順では、最新の「Fall Creators Update」(最小バージョン 1709、ビルド 16299.15) を適用した少なくとも Windows 10 以降を使用してください。 手順については、公式ガイド Linux 用の Windows サブシステムをインストールするを参照してください。

    WSL 2 を使用するには、Windows のバージョンが 10 ビルド 18917 以降である必要があります。 これらの手順(英語)に従って、ディストリビューションを切り替えます。

    GoLand は、システムを Windows 10 のビルド 16299.15 以降にアップグレードする前にインストールした可能性がある 既存 WSL をサポートしていないことに注意してください。 この場合、WSL ディストリビューションを更新する必要があります。

  2. Linux ディストリビューションを実行します。

    最初の起動時に、システムは Windows のオプション機能を有効にするように求めるメッセージを表示する場合があります。 この場合、次のことを行う必要があります。

    • 管理者として Windows PowerShell を開き、実行します

      Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
    • コンピューターを再起動してください。

  3. ホームディレクトリから、tarball をダウンロードします。

    wget https://go.dev/dl/go1.22.0.linux-amd64.tar.gz
  4. アーカイブを /usr/local に抽出します。

    tar -C /usr/local -xzf go1.22.0.linux-amd64.tar.gz
  5. ホームディレクトリ(cd ~ )に、 go フォルダーを作成します。

    mkdir go
  6. GOPATH と GOROOT を構成します。

    export GOROOT=/usr/local/go
    export GOPATH=$HOME/go
    export PATH=$PATH:/usr/local/go/bin

プロジェクトを作成して WSL 環境に保存し、WSL ファイルシステムからプロジェクトを開いて、WSL でプロジェクトをさらに開発することができます。

WSL ファイルシステムで新しいプロジェクトを作成する

  1. 通常どおり、Windows 上でローカルに インストールして実行 GoLand を実行します。

  2. ようこそ画面で、 新規プロジェクト をクリックします。

  3. 閲覧 ボタンをクリックして、新しいプロジェクトを作成する WSL のディレクトリに移動します。

    ベースディレクトリを選択 ダイアログで、 新規フォルダー ボタン(the New Folder icon )をクリックして、プロジェクトのフォルダーを作成できます。

    WSL のプロジェクトの場所には、 \\wsl$ で始まる WSL ファイルシステムへの絶対パスが表示されます。

  4. 作成 をクリックしてください。

    GoLand は WSL にあるプロジェクトを作成し、IDE を離れることなく WSL 環境内でプロジェクトを開発およびビルドできます。

    wsl にプロジェクトフォルダーを作成する

WSL ファイルシステムに保存されているプロジェクトを開く

GoLand では、WSL ファイルシステムに保存されているプロジェクトを直接開いて、他のプロジェクトと同じように操作できます。

  1. 'ようこそ' 画面 の 開く をクリックするか、メインメニューから ファイル | 開く を選択します。

  2. 開いたダイアログで、開くプロジェクトが含まれている WSL ファイルシステム内のフォルダーを選択するか、プロジェクトの場所へのパスを手動で入力します。

    パス構文は \\wsl.localhost\DistributionName です。ここで、 DistributionName はLinuxディストリビューションの名前(例:Ubuntu、Debian、Archなど)です。

    wsl で既存のプロジェクトを開く

プロジェクトの場所を設定する

作成または開くすべてのプロジェクトで、適切な WSL の場所が使用されるようにできます。

  1. Ctrl+Alt+S を押して設定を開き、 外観 & 振る舞い | システム設定 を選択します。

  2. プロジェクト セクションの デフォルトのプロジェクトディレクトリ フィールドで、適切な WSL ディレクトリを指定し、 OK をクリックして変更を保存します。

    デフォルトのプロジェクトディレクトリ

    今後は、プロジェクトを 作成する、 開く 、または クローンするたびに、指定したディレクトリがデフォルトで選択されます。

プロジェクトでコードを 実行すると、WSL で実行されます。 実行構成を開く場合、GoLand は WSL をローカルマシンとして参照していることに注意してください。

実行構成

コード実行の結果は、 実行 ツールウィンドウに表示されます。

プロジェクトで WSL 環境を使用する

Windows 上でローカルにプロジェクトを 作成または 開き、 実行ターゲットを使用して WSL でコンパイルされたコードを実行できます。 これは、クロスプラットフォーム開発に役立つ可能性があります。

実行ツールウィンドウ: WSL 出力

WSL 構成を作成する

  1. メインメニューで、 実行 | ターゲットの管理 をクリックします。

  2. ターゲットを追加 ウィンドウから WSL を選択します。

    リストの実行から wsl を選択する
  3. 新規ターゲット ウィザードで、 Linux ディストリビューション リストから Linux ディストリビューションを選択します。 分布が自動的に検出され、イントロスペクションに合格した場合は、 次へ をクリックします。

  4. WSL の Go ランタイム構成が正しく検出されたことを確認し、 完了 をクリックします。

    または、独自の設定を入力します。

    • 実行可能にする: Go 実行可能ファイルへのパス (たとえば、 /usr/local/go/bin/go )

    • GOPATH: ターゲットの GOPATH。 GoLand は go env GOPATH を実行して、この値を自動的に検出します。

    • バージョン: Go のバージョン。 GoLand は go version を実行して、この情報を自動的に検出します。

    • 追加設定: ソースコードファイルと実行可能ファイルのディレクトリを設定できるようにする設定のグループ。

      ターゲットで実行するために、GoLand はソースファイル、作業ディレクトリのファイル、コンパイル済みの実行可能ファイル、Delve をアップロードします。 追加設定 でパスを指定しない場合、GoLand はソースファイルと実行可能ファイル用のディレクトリを作成します。

      次のオプションを指定できます。

      • プロジェクトソースディレクトリ: ソースコードファイルがアップロードされるターゲット上のディレクトリ。

      • コンパイルされた実行可能ファイルディレクトリ: コードが生成する実行可能ファイルを格納するために使用されるターゲット上のディレクトリ。

    WSL の Go ランタイム構成を確認する
  5. ターゲットの実行 ダイアログで、 プロジェクトのデフォルトターゲット リストをクリックし、作成した構成を選択します。

    実行ツールウィンドウ: WSL 出力
  6. アプリケーションを実行します。

    WSL 構成を作成する

ファイアウォール構成

プロジェクトのビルドが正しく行われるよう、次の手順を実行してください。

ファイアウォール設定を構成する

  1. Windows PowerShell を管理者として実行してください。

    ファイアウォールをデフォルトに戻す
  2. 名前を変更した場合は、次のコマンドを使用して、 vEthernet (WSL)、 vEthernet (WSL2) などの正確なインターフェース名を確認します。

    Get-NetAdapter
  3. 次のコマンドを実行して、WSL を使用した接続を許可します。

    New-NetFirewallRule -DisplayName "WSL" -Direction Inbound -InterfaceAlias "vEthernet (WSL)" -Action Allow
  4. 次に、コマンドを実行してファイアウォールルールを更新します。

    Get-NetFirewallProfile -Name Public | Get-NetFirewallRule | where DisplayName -ILike "GoLand*" | Disable-NetFirewallRule
  5. 次に、 デバッガーセッションを開始します。 Windows ファイアウォール ポップアップが表示されたら、 パブリックネットワーク チェックボックスを選択します。

WSLg

WSLg により、Linux GUI アプリケーションを実行し、その出力を Windows デスクトップに表示できます。

WSLg 経由で GoLand を実行することはおすすめしません。 GoLand にはすでにネイティブ WSL 統合が用意されており、これが推奨される方法です。

以下の点に留意してください:

  • WSLg には、レンダリング、ポップアップ、ウィンドウ管理、入力メソッド、デスクトップ統合に関する制限があります。

  • WSLg 経由で GoLand を実行するための専用サポート、インストールガイダンス、オンボーディング、製品固有の修正は提供していません。

プロジェクトを開く方法については WSL ファイルシステムに保存されているプロジェクトを開く を参照し、新しいプロジェクトを作成する場合は WSL ファイルシステムで新しいプロジェクトを作成する を参照してください。

2026 年 11 月 6 日