快速入门指南
本指南可帮助您开始使用 GoLand。 您将学习如何创建和打开项目、处理文件、运行代码并在 IDE 中进行导航。
启动 Go 项目
首次安装并启动 GoLand 后,您需要创建一个项目。 GoLand 中的所有操作均在项目环境中进行。 项目是代码辅助、重构、统一编码风格及其他关键功能的基础。
在 IDE 中开始处理项目有以下三种方式:
打开现有项目
从版本控制系统 (VCS) 中检出项目
创建新项目
本快速入门指南仅介绍如何创建一个新项目。
创建 Go 项目
选择 。
或者,在 欢迎访问GoLand 对话框中导航至 新建 | 项目。
在 新建项目 对话框中,从可用项目类型列表中选择 Go modules。
在 GOROOT 字段中指定 Go 安装的位置。 GoLand 通常会自动检测该位置。
如需更改或安装新的 Go SDK 版本,请单击 添加 SDK (
),然后选择以下选项之一:
本地 :使用本地系统中现有的 SDK。
下载 :从官方存储库下载 Go SDK 版本。
单击 创建 以创建项目。

创建 Go 文件
要创建 Go 文件,可使用以下任一方式:
在 项目 工具窗口中,右键单击项目的父文件夹,然后选择 。
单击项目的父文件夹,按 Alt+Insert ,然后选择 Go 文件。
单击项目的父文件夹,然后进入 。
在 新建Go 文件 对话框中,输入文件名并选择文件类型:
空文件 — 创建一个空的 Go 文件。
简单应用程序 — 创建一个包含预定义
main函数的 Go 文件。

探索用户界面
首次启动 GoLand 时,将显示 欢迎访问GoLand 对话框。 在此对话框中,您可以创建或打开项目、从版本控制系统检出项目、访问文档以及配置 IDE。
打开项目后,主窗口将显示为多个逻辑区域:

左侧的 项目工具窗口显示项目文件。 工具窗口有助于项目管理、导航、运行和调试代码、集成版本控制等。 要查看所有可用的工具窗口,请转到 。
右侧的 编辑器窗格是编写代码的区域。 您可以使用选项卡在打开的文件间切换。
编辑器上方的导航栏可用于快速运行和调试应用程序及执行基本的 版本控制操作。
Gutter 是编辑器旁的垂直条。 它显示断点并提供到定义或声明的导航。 您还可以单击 运行应用程序 图标(
)以运行或调试应用程序。
编辑器右侧的 滚动条 显示代码分析标记。 GoLand 会持续检查代码,并突出显示错误、警告和拼写错误等问题。 编辑器边缘顶部的指示器显示该文件的整体代码检查状态。
状态栏显示项目和 IDE 的状态。 它提供有关文件编码、行分隔符、检查配置文件以及其他有用信息的详细内容。
在 IDE 左下角的 状态 栏中,您可以找到 或
按钮。 该按钮用于切换工具窗口栏的可见性。 将鼠标悬停于其上可查看当前可用的工具窗口列表。
编写代码
在编辑器中工作时,GoLand 会分析您的代码,提出优化建议,并检测潜在或实际的问题。 下面列出的功能可以帮助您更高效地编写代码,并提升整体开发体验:
重构
重构是指在不引入新功能的前提下改进源代码的过程。 重构有助于保持代码稳健、 干净且易于维护。
GoLand 提供以下重构选项:
代码补全
GoLand 提供两种类型的代码补全:
基本代码补全 Ctrl+Space 可在当前作用域中补全类型、接口、方法和关键字名称。 建议内容会在输入时自动显示。
智能代码补全 Ctrl+Shift+Space 会筛选列表,仅显示适用于当前上下文的值。
以下动画展示了基本补全与智能类型匹配补全之间的区别。 请注意每种类型所提供的建议数量:
生成代码
GoLand 提供多种生成通用代码结构和重复元素的方法,帮助提升您的工作效率。 这些方法可以是创建新文件时使用的 文件模板 、根据上下文应用的自定义或预定义 实时模板 、各种包装器或字符自动配对功能。
您可以生成 getter、setter、构造函数、缺失的方法以及测试文件。
有关更多信息,请参阅 使用 Generate 操作。

实时模板
使用 实时模板将常见结构插入代码中,例如循环、条件、声明或打印语句。
若要查看实时模板列表,请按下 Ctrl+Alt+S 并转到 。
以下动画展示了如何使用实时模板创建
Hello World程序:
代码检查
在 GoLand 中,有一套代码检查机制可在编译前检测并修复项目中的异常代码。 IDE 可查找并高亮各种问题、定位无效代码、发现可能的 bug、拼写问题,并改善整体代码结构。
检查可扫描项目中的所有文件,或仅针对特定 范围 (例如,仅生产代码或已修改文件)进行扫描。
每项检查都有一个 严重性等级——代表问题对代码可能造成的影响程度。 编辑器会以不同方式高亮显示严重性,以便于快速区分严重问题与次要问题。 GoLand 提供一组预定义的严重性等级,并允许您自定义。
要查看和配置检查,请按 Ctrl+Alt+S 并导航至 。 您可以启用或禁用检查,并更改其严重性等级。
例如, 不可到达的代码 检查可检测不可达代码。

意图操作
在编辑器中工作时,GoLand 会分析您的代码并寻找优化方式。 意图操作涵盖从错误和警告到优化建议等多种情况。
在 GoLand 中,您可以使用以下类型的意图操作:
意图操作
:生成一段代码或为您的代码提供替代方案的操作。 通常,意图操作适用于已符合语法规范的代码。 点击黄色灯泡图标可查看当前上下文中可用的 意图操作。 例如,您可以创建一个构造函数来生成结构体类型的值。 或者,将 if-else 语句替换为等效的语句,但使用取反条件并交换分支。快速修复
:为代码中的问题提供解决方案的操作。 通常,意图操作适用于存在错误的代码。 例如,表达式末尾缺少括号时。 或者,您忘记将某个值转换为指定类型时。
要查看可用的意图操作列表,请按 Ctrl+Alt+S 并导航至 。
单击灯泡图标或按 Alt+Enter 打开建议列表。
从列表中选择一个操作并按 Enter。
例如,您可以使用意图操作将其他语言注入到代码中:

运行并调试代码
您可以使用键盘、上下文菜单、标尺菜单,或创建一个 Run/Debug configuration 来在 GoLand 中运行并调试代码。
运行代码
要运行应用程序,请按 Shift+F10 ,或单击标尺中的 运行应用程序 图标
并选择 运行 <application_name>。

调试代码
调试 从设置断点开始,断点会挂起程序执行,以便您检查程序数据。 要设置断点,请单击标尺中希望程序暂停执行的行号。
To debug your application, press Shift+F9, or click the 运行应用程序 icon
in the gutter and select 调试 <application_name>. 然后,使用 菜单或 Debug tool window 中的选项逐步执行。
如需了解更多信息,请参阅 调试。
