GoLand 2021.2 Help

Create a new project

By default, GoLand suggests creating a Go modules project. With Go modules, you do not need to keep your project files under GOPATH and can easily manage dependencies in your project. Read more about Go modules at blog.golang.org.

If you plan to work on a project that does not require complex dependency management, consider creating the Go (GOPATH) project (File | New | Project). Note that without Go modules, you need to store your source code under the GOPATH directory (a Go workspace). Also, you cannot install multiple versions of the same dependency package since the go get command downloads the dependency package to the same directory.

General procedure of creating a project

  1. Click File | New | Project. Alternatively, on the Welcome screen, click New Project.

  2. On the New Project page, select what project type you want to create. You can see a list of project types in the Project types table.

  3. In the GOROOT field, specify the location of your Go installation. Usually, the location is defined automatically.

    To change or install a new version of Go SDK, click the Add SDK… button and select Local… to choose the Go SDK version on your hard drive, or select Download… to download Go SDK from the official repository. For more information about installing Go SDK, see Installing Go SDK.

  4. Click Create.

Project types

Project typeDescription
GoA project with Go modules dependency management.
DepA project with dep dependency management. The dep tool was initially developed to experiment with dependency management system for Go. From Go 1.11, the Go project has officially adopted a different approach, based on the concept of Go modules.
App EngineA project with Google App Engine integration. With App Engine integration, you can run and debug Google App Engine applications. For more information about App Engine, see App Engine at cloud.google.com.
HTML5 BoilerplateA project with integration with the HTML5 Boilerplate framework. For more information about HTML5 Boilerplate, see documentation at html5boilerplate.com.
ReactA project with React integration. For more information about React, see documentation at reactjs.org.
BootstrapA project with Bootstrap integration. Read more about Bootstrap at https://getbootstrap.com.
React NativeA project with React integration. React Native is an open-source mobile application framework. For more information about React Native, see documentation at reactnative.dev.
WebAssembly (Wasm)A project with WebAssembly integration. WebAssembly (Wasm) is a binary code that you can run in a browser. GoLand supports generation of WASM files from GO files. You can read more about WebAssembly in WebAssembly documentation at webassembly.org.

Installing Go SDK

Select a local copy of the Go SDK

Ensure that the provided path to the folder with Go SDK includes bin and src folders.

  1. In the New Project dialog, select Go (GOPATH).

  2. Click the Add SDK button and select Local.

  3. In the file browser, navigate to the SDK version that is on your hard drive.

  4. Click Open.

Download the Go SDK

  1. In the New Project dialog, select Go (GOPATH).

  2. Click the Add SDK button select Download.

  3. From the Version list, select the SDK version.

  4. In the Location field, specify the path for the SDK. To use a file browser, click the Browse icon the Browse icon.

  5. Click OK.

Last modified: 08 July 2021