WSL

1. Download and install a WSL distribution (for instance, Ubuntu) from Microsoft Store.

   For this step, be sure to use at least Windows 10 or later with the latest “Fall Creators Update” (minimum version 1709, build 16299.15). See the official guide Install the Windows Subsystem for Linux for instructions.

   To work with WSL 2, your Windows version should be 10 build 18917 or later. Follow these instructions to switch the distributive.

   Note that GoLand does not support legacy WSL, which you may have installed before upgrading your system to the build 16299.15 or later of Windows 10. In this case, you need to update your WSL distribution.

2. Run the Linux distribution.

   Upon the first launch, the system may prompt you to enable the Windows optional feature. In this case, you need to do the following:

   • Open Windows PowerShell as Administrator and run

     Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

   • Restart your computer.

   note

   If you are using Linux distribution other than Ubuntu, ensure that the distribution has the iproute2 package installed or install it manually once the WSL instance is deployed.

3. From your home directory, download the tarball.

   wget https://go.dev/dl/go1.22.0.linux-amd64.tar.gz

4. Extract the archive to /usr/local.

   tar -C /usr/local -xzf go1.22.0.linux-amd64.tar.gz

5. In your home directory (cd ~), create the go folder.

   mkdir go

6. Configure GOPATH and GOROOT.

   export GOROOT=/usr/local/go

   export GOPATH=$HOME/go

   export PATH=$PATH:/usr/local/go/bin

1. Install the needed Go version to the WSL environment.

   note

   You cannot use the Windows Go SDK for your WSL projects, ensure to select Go SDK that is installed in WSL. Alternatively, use run targets.

2. On the welcome screen, click New Project.

3. Click the Browse button and navigate to the directory in WSL where you want to create a new project.

   In the Select Base Directory dialog, you can click the New Folder button () to create a folder for a project.

   The project location for WSL will show the absolute path starting with \\wsl$ to the WSL file system.

4. Click Create.

   GoLand creates a project located in WSL and you can develop and build your project inside the WSL environment without leaving the IDE.

   

In GoLand, you can directly open a project stored in the WSL file system and work with it like with any other project.

• Click the Browse button and navigate to the directory in the WSL file system that you want to open. Also, you can type the path to the \\wsl$ project location manually.

  note

  You cannot use the Windows Go SDK for your WSL projects, ensure to select Go SDK that is installed in WSL. Alternatively, use run targets.

  

1. To run Terminal in WSL configuration, open project Settings/Preference (CtrlAlt0S) and go to Tools | Terminal.

2. Specify the command in the Shell path field:

   • wsl.exe to use the default Linux distribution

   • wsl.exe -d <distribution name> to use a specific Linux distribution

   Click OK to save changes.

   

3. Switch to the Terminal tool window and type any command to inspect the output.