Dep

Create a project with dep integration

By default, IntelliJ IDEA creates a project with Go modules integration. You can disable this option in settings. But ensure that you keep the necessary file structure and store your project under GOPATH. For more information about storing your code under GOPATH, see How to Write Go Code (with GOPATH) at go.dev.

Firstly, you need to create a default Go project with Go modules integrations but be sure to place your project under GOPATH.

Create a project with Go integration

Select File | New | New Project.
Alternatively, click New Project in the Welcome to IntelliJ IDEA dialog.
In the Name field, type a name of your project.
In the Location field, specify the path where you want to store your project.
If you want to initiate a git repository for the project, select the Create Git repository checkbox.
In the Language list, click the Install Plugin icon (), and select Go. If you have already installed the Go plugin, select it from the Language list.
If the Go plugin is not installed, in the Plugins dialog, find the Go plugin and click Install.
Click OK to close the Plugins dialog.
In the New Project dialog, select New Project from the list of available projects.
Ensure that Go is selected as a project language in the Language list.
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.
(Optional) Select or clear the Enable vendoring support automatically checkbox.
Since Go 1.14 RC, the automatic vendoring mode became a built-in Go feature. For Go versions 1.14 RC and later, the Enable vendoring support automatically checkbox is disabled. For more information about vendoring, see Vendoring.
(Optional) In the Environment field, specify environment variables that you need for your project. For example, the GOPROXY environment variable. Read more about environment variables in the Environment variables section.
Click Create.

Secondly, disable Go modules integration.

Disable the Go modules integration

Press Ctrl+Alt+S to open the IDE settings and select Languages & Frameworks | Go | Go Modules.
Clear the Enable Go modules integration checkbox.

Finally, enable dep integration.

Enable dep integration

Install the dep distribution.
Open settings by pressing Ctrl+Alt+S and navigate to Languages & Frameworks | Go | Dep
Select the Enable dep integration checkbox.
From the Dep Executable list, select a path to the dep executable. To select a path to the dep executable manually, click the Browse button () and navigate to the folder with the dep executable.
Click OK.

Working with dependencies

Ensure that you create your Dep project under $GOPATH/src. The GOPATH variable points to a root directory that contains bin, pkg, and src subdirectories. The project source is under src. Tools like godep and go install operate on the project source, not on the entire GOPATH. For more details about the dep project, see the Go Workspace documentation.

If you want to use any location for the project source, consider using Go modules integration.

Import dependencies

Click the dependency declaration.
Press Alt+Enter and select dep ensure.

Installing Go SDK

Select a local copy of the Go SDK

Press Ctrl+Alt+S to open the IDE settings and select Languages & Frameworks | Go | GOROOT.
Click the Add SDK button () and select Local….
In the file browser, navigate to the SDK version that is on your hard drive.
Click Open.

Download the Go SDK

Press Ctrl+Alt+S to open the IDE settings and select Languages & Frameworks | Go | GOROOT.
Click the Add SDK button () and select Download….
From the Version list, select the SDK version.
In the Location field, specify the path for the SDK. To use a file browser, click the Browse icon ().
Click OK.

Last modified: 10 August 2022