GoLand 2019.2 Help

Content roots

In GoLand, content is a collection of files with which you are currently working, possibly organized in a hierarchy of subfolders. The folder which is the highest in this hierarchy is called the content root folder or content root (shown as the Content root icon ) for short. A project has at least one content root folder, which by default is the project folder itself.

Having several content roots enables you to work with files from several directories that do not have a common immediate parent. This is helpful when you use static contents, for example, icons. You can just save them all in a folder and then specify this folder as an extra content root in several projects.

Content root types

By default, all the files in a content root folder are involved in indexing, searching, parsing, code completion, and so on. To change this status, folders within a content root can be assigned to the following categories:

  • Resource roots (or resource folders; shown as the Resources root icon ).

    These roots are intended for resource files in your application (images, style sheets, and so on). By assigning a folder to this category, you tell GoLand that files in it and in its subfolders can be referenced relative to this folder instead of specifying full paths to them.

  • Excluded (shown as the Excluded root icon ) are ones that GoLand "almost ignores".

    These excluded categories contain files and folders ignored by GoLand when indexing, searching, parsing, watching and so on.

    Excluded roots are not visible to GoLand. Usually, one would like to exclude temporary build folders, generated output, logs, and other project output. Excluding the unnecessary paths is a good way to significantly improve performance.

Last modified: 6 September 2019

See Also