GoLand 2025.2 Help

快速入门指南

本指南可帮助您开始使用 GoLand。 您将学习如何创建和打开项目、处理文件、运行代码并在 IDE 中进行导航。

启动 Go 项目

首次安装并启动 GoLand 后,您需要创建一个项目。 GoLand 中的所有操作均在项目环境中进行。 项目是代码辅助、重构、统一编码风格及其他关键功能的基础。

在 IDE 中开始处理项目有以下三种方式:

  • 打开现有项目

  • 从版本控制系统 (VCS) 中检出项目

  • 创建新项目

本快速入门指南仅介绍如何创建一个新项目。

创建 Go 项目

  1. 选择 文件(F) | 新建(N) | 项目…

    或者,在 欢迎访问GoLand 对话框中导航至 新建 | 项目

  2. 新建项目 对话框中,从可用项目类型列表中选择 Go modules

  3. GOROOT 字段中指定 Go 安装的位置。 GoLand 通常会自动检测该位置。

    如需更改或安装新的 Go SDK 版本,请单击 添加 SDK添加 SDK 图标 ),然后选择以下选项之一:

    • 本地 :使用本地系统中现有的 SDK。

    • 下载 :从官方存储库下载 Go SDK 版本。

  4. 单击 创建 以创建项目。

    与 Go module 集成

创建 Go 文件

  1. 要创建 Go 文件,可使用以下任一方式:

    • 项目 工具窗口中,右键单击项目的父文件夹,然后选择 新建(N) | Go 文件 Go 文件

    • 单击项目的父文件夹,按 Alt+Insert ,然后选择 Go 文件

    • 单击项目的父文件夹,然后进入 文件(F) | 新建(N) | Go 文件

  2. 新建Go 文件 对话框中,输入文件名并选择文件类型:

    • 空文件 — 创建一个空的 Go 文件。

    • 简单应用程序 — 创建一个包含预定义 main 函数的 Go 文件。

    创建 Go 文件

探索用户界面

首次启动 GoLand 时,将显示 欢迎访问GoLand 对话框。 在此对话框中,您可以创建或打开项目、从版本控制系统检出项目、访问文档以及配置 IDE。

打开项目后,主窗口将显示为多个逻辑区域:

项目视图、编辑器和工具窗口
  1. 左侧的 项目工具窗口显示项目文件。 工具窗口有助于项目管理、导航、运行和调试代码、集成版本控制等。 要查看所有可用的工具窗口,请转到 视图 | 工具窗口

  2. 右侧的 编辑器窗格是编写代码的区域。 您可以使用选项卡在打开的文件间切换。

  3. 编辑器上方的导航栏可用于快速运行和调试应用程序及执行基本的 版本控制操作

  4. Gutter 是编辑器旁的垂直条。 它显示断点并提供到定义或声明的导航。 您还可以单击 运行应用程序 图标(运行应用图标 )以运行或调试应用程序。

  5. 编辑器右侧的 滚动条 显示代码分析标记。 GoLand 会持续检查代码,并突出显示错误、警告和拼写错误等问题。 编辑器边缘顶部的指示器显示该文件的整体代码检查状态。

  6. 状态栏显示项目和 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 并导航至 编辑器 | 意图

  1. 单击灯泡图标或按 Alt+Enter 打开建议列表。

  2. 从列表中选择一个操作并按 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 中的选项逐步执行。

    如需了解更多信息,请参阅 调试

    调试代码
最后修改日期: 2025年 9月 26日