安装并配置 GoLand
有多种方式可以安装 GoLand。 本指南将采用 JetBrains Toolbox 应用的方式，因为它可以更轻松地管理 IDE 安装。 有关其他安装选项的更多信息，请参阅 安装指南。
使用 Toolbox 应用安装
JetBrains Toolbox 应用是安装 JetBrains 产品的推荐工具。 可用于安装和管理不同产品或同一产品的多个版本，包括 Early Access Program （EAP）和每晚构建，必要时可更新或回退，并轻松删除任意工具。 Toolbox 应用会维护全部项目的列表，便于快速以正确的 IDE 和版本打开任意项目。
有关每晚构建的更多信息，请参阅 什么是每晚构建？ 常见问题部分中。
安装 Toolbox 应用
从 Toolbox 应用网页下载安装程序 .exe 。
运行安装程序并按照向导步骤操作。
运行 Toolbox 应用后，点击通知区域中的图标
，然后选择要安装的产品。若要安装特定版本，请点击
并选择 可用版本。
若要安装每晚构建版本，请从版本列表中选择名称中带有 Nightly 的版本（例如，2021.1 Nightly）。
在 Toolbox 应用中登录您的 JetBrains 账户，安装的任何 IDE 将自动激活可用许可证。
安装 Toolbox 应用
从 Toolbox 应用网页下载磁盘映像 .dmg 。
挂载磁盘映像，并将 JetBrains Toolbox 应用拖动到 Applications 文件夹。
运行 Toolbox 应用后，点击主菜单中的图标，并选择要安装的产品。
若要安装特定版本，请点击
并选择 可用版本。
若要安装每晚构建版本，请从版本列表中选择名称中带有 Nightly 的版本（例如，2021.1 Nightly）。
在 Toolbox 应用中登录您的 JetBrains 账户，安装的任何 IDE 将自动激活可用许可证。
安装 Toolbox 应用
x86_64：
glibc 2.17（Ubuntu 18.04 或更高版本）
arm64：
glibc 2.29（Ubuntu 20.04 或更高版本）
从 Toolbox App 网页下载 tarball .tar.gz 。
解压 tarball 并启动可执行文件：
tar -xzf jetbrains-toolbox-<build>.tar.gz && cd jetbrains-toolbox-<build>/bin && ./jetbrains-toolboxToolbox App 将安装到
$HOME/.local/share/JetBrains/Toolbox/bin并从该位置运行。首次运行 Toolbox App 后，它会自动将 Toolbox App 图标
添加到主菜单中。选择您要安装的产品。
要安装特定版本，请点击
并选择 可用版本。
要安装夜间构建版本，请在版本列表中选择名称中包含 Nightly 的版本（例如，2025.2 Nightly）。
从 Toolbox App 登录 JetBrains Account，它会为您安装的所有 IDE 自动激活可用许可证。
配置工作环境
安装完成后，您可以 打开或创建项目、 配置 Go SDK 以及自定义 IDE。 自定义包括 设置首选键位映射 （例如 VS Code 键位映射），以及从 JetBrains Marketplace 安装插件或扩展 来增强功能。
打开项目
安装并首次启动 GoLand 后，您需要创建一个项目。 在 GoLand 中执行的所有操作都在项目的上下文中完成。 项目是代码辅助、大规模重构、代码风格一致性和其他功能的基础。
在 IDE 中开始项目工作的方式有三种：
打开现有项目
在 欢迎访问GoLand 屏幕上，点击 打开。
或者，点击 。
在文件浏览器中，导航至包含项目文件的文件夹并点击 打开(O)…。
添加SDK… ：使用本地 SDK 副本。 在文件浏览器中，导航至存储在硬盘中的 SDK 版本。
下载… ：下载 SDK。 在 位置 字段中，指定 SDK 的路径。 如需使用文件浏览器，请点击 浏览… 图标
。 点击 确定(O)。点击 确定(O)。
打开项目后，您需要指定 Go SDK 的位置。 您可以指定本地 SDK 路径或下载 SDK。 要设置 Go SDK，请打开设置 Ctrl+Alt+S 并导航至 。 点击 添加 SDK 按钮并选择以下两个选项之一：
从版本控制系统克隆现有项目
在 欢迎 屏幕上，点击 克隆。
在 版本控制 列表中，选择 Git 或 Mercurial：
要从 GitHub 检出文件，请选择 GitHub 并点击 通过GitHub 登录…。 您将被重定向至 account.jetbrains.com ，需要点击 在 GitHub 中授权。 输入您的 GitHub 凭据并授权访问您的 GitHub 帐号。
要从 Mercurial 检出文件， 安装并配置 Mercurial ，然后重启 GoLand。 输入源代码路径并将仓库克隆到您的计算机。
打开项目后，您需要指定 Go SDK 的位置。 您可以指定本地 SDK 路径或下载 SDK。 要设置 Go SDK，请打开设置 Ctrl+Alt+S 并导航至 。 点击 添加 SDK 按钮并选择以下两个选项之一：
添加SDK… ：使用本地 SDK 副本。 在文件浏览器中，导航至硬盘上的 SDK 版本。
下载… ：下载 SDK。 在 位置 字段中，指定 SDK 的路径。 要使用文件浏览器，请点击 浏览… 图标
。 点击 确定(O)。
有关版本控制系统的更多信息，请参阅 版本控制。
创建 Go 项目
选择 。
或者，在 欢迎访问GoLand 对话框中导航至 新建 | 项目。
在 新建项目 对话框中，从可用项目类型列表中选择 Go。
在 GOROOT 字段中，指定 Go 安装位置。 GoLand 通常会自动检测该位置。
要更改或安装新的 Go SDK 版本，请点击 添加 SDK （
），然后选择以下选项之一：本地 ：使用本地系统中的现有 SDK。
下载 ：从官方存储库下载 Go SDK 版本。
（可选）选中或取消选中 自动启用供应支持 复选框，以启用或禁用 vendoring 支持。
（可选）在 环境 字段中，指定项目所需的任何环境变量。 例如，
GOPROXY。要了解更多信息，请参阅 环境变量部分。
点击 创建 创建项目。
配置 Go
要在 GoLand 中启动项目，需配置 Go SDK。 您可以使用计算机上已有的 SDK，也可以从 GoLand 下载。
配置 GOROOT
要查看 GOROOT 的当前值，请打开设置（Ctrl+Alt+S ），然后导航至 。 点击下拉列表并选择 Go 版本。
若无 Go 版本可选，请点击 添加 SDK 按钮以 下载 Go 版本或 选择本地 Go SDK 的路径。
选择本地 Go SDK 副本
请确保所提供的 Go SDK 文件夹路径中包含 bin 和 src 文件夹。
打开设置（Ctrl+Alt+S ），然后导航至 。
点击 添加SDK 按钮
，然后选择 本地。在文件浏览器中，导航至硬盘上的 SDK 版本。
点击 打开。
下载 Go SDK
打开设置（Ctrl+Alt+S ），然后导航至 。
点击 添加SDK 按钮（
），然后选择 下载。从 版本 列表中选择 SDK 版本。
在 位置 字段中，指定 SDK 的路径。 要使用文件浏览器，请点击 浏览 图标
。点击 确定 以关闭 下载Go SDK 对话框。
当您点击 应用 或 确定 位于 GOROOT 页面上时，GoLand 将开始下载并解压 Go SDK。
配置键位映射
您可以使用 IDE 的默认键位映射，或使用 VS Code 的键位映射。 如果需要可打印的默认快捷键 PDF，请点击 以下链接。
设置 Visual Studio Code 键位映射
要查看键位映射配置，请打开 设置 对话框 Ctrl+Alt+S 并选择 键盘映射。
在下拉菜单中选择 VSCode。
安装扩展
在 GoLand 中，扩展称为 插件。 其功能类似于 VS Code 中的扩展，帮助您增强内置功能并自定义 IDE。
从插件市场安装插件
按 Ctrl+Alt+S 打开设置，然后选择 。
点击 插件市场 选项卡，在搜索字段中输入插件名称。
要安装插件，请单击 安装 ，然后重启 GoLand。
要安装特定版本，请前往 JetBrains Marketplace 插件页面，按 从磁盘安装插件 中所述下载并安装。 例如，当插件的最新版本出现故障时，您可以采用此方法。
如需了解插件的更多信息，请参阅 插件。