# 快速入门 Go

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **TL;DR**
> 必需插件： [Go](https://plugins.jetbrains.com/plugin/9568-go)

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

> **Note:**
> 如果在使用 IDE 时遇到问题，请参阅我们的 [支持与帮助](getting-help.html) 文章。 在此，您可以找到寻求答案的来源或直接向我们的团队提问。

## 开始一个 Go 项目

在您安装 Go 插件并首次启动后，您需要创建一个项目。 在 IntelliJ IDEA 中，所有操作都在项目的上下文中完成。 项目是代码辅助、重构、一致的编码风格以及其他关键功能的基础。

您有三种选项可以在 IDE 中开始处理一个项目：

* 打开现有项目

* 从版本控制系统 (VCS) 中检出一个项目

* 创建一个新的项目

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

Procedure: 创建 Go 项目

1. 选择  `文件 | 新建 | {0, choice, 0#新建|1#}{1, choice, 0#Java |1#}项目…` 。

或者，在   欢迎来到 %instance%   对话框中，转到   新建 | 项目  。

2. 在   新建项目   对话框中，从可用项目类型列表中选择   Go 模块  。

确保在   语言   列表中选择 Go 作为项目语言。

3. 在   GOROOT   字段中，指定 Go 安装位置。 IntelliJ IDEA 通常会自动检测到此位置。

要更改或安装新的 Go SDK 版本，请点击   添加 SDK  （ ![添加 SDK 图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.add.svg)），然后选择以下选项之一：

* 本地 ：使用本地系统中的现有 SDK。

* 下载 ：从官方存储库下载一个 Go SDK 版本。

4. 点击   创建   创建项目。

![下载 Go SDK](https://resources.jetbrains.com/help/img/idea/2026.3/go_ij_create_go_modules_project.png)

Procedure: 创建 Go 文件

1. 要创建 Go 文件，请使用以下选项之一：

* 在 项目 工具窗口中，右键点击项目的父文件夹并选择 `新建 | Go 文件Go 文件` 。

* 点击项目的父文件夹，按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Alt+Insert` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Alt+Insert` (Visual Studio), `⌘ ⌃ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))，然后选择 Go 文件 。

* 点击项目的父文件夹，然后转到 `文件 | 新建 | Go 文件` 。

2. 在   新建 Go 文件   对话框中，输入文件名称并选择文件类型：

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

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

![创建 Go 文件](https://resources.jetbrains.com/help/img/idea/2026.3/go_ij_qst_create_go_file.png)

## 探索用户界面

首次启动 IntelliJ IDEA 时，会显示欢迎屏幕。 可以创建或打开项目、克隆仓库、访问文档并配置 IDE。

打开项目后，主窗口会出现，并分为几个逻辑区域：

![项目视图、编辑器和工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/go_ij_QST_lookAroundThumb.png)

1.  左侧的 [项目](project-tool-window.html)工具窗口显示您的项目文件。 工具窗口有助于项目管理、导航、运行和调试代码、版本控制集成等。 要查看所有可用的工具窗口，请转到  `视图 | 工具 Windows` 。

2.  右侧的 [编辑器](using-code-editor.html)窗格是您编写代码的地方。 您可以使用选项卡在打开的文件之间切换。

3.  导航栏显示当前项目和文件位置。 使用“运行”和“调试”操作来执行当前配置。

4.    装订区域   是编辑器旁边的垂直条。 它显示断点并提供到定义或声明的导航。 您还可以点击   运行应用程序   图标（ ![运行应用程序图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.runConfigurations.testState.run_dark.svg)）来运行或调试您的应用程序。

5.  编辑器右侧的   滚动条   包括代码分析标记。 IntelliJ IDEA 会持续检查您的代码，并高亮显示错误、警告和拼写错误等问题。 边距顶部的指示器显示文件的整体检查状态。

6.  [状态栏](null) 显示您的项目和 IDE 的状态。 它提供有关文件编码、行分隔符、检查配置文件和其他有用消息的详细信息。

在 IDE 的左下角，在   状态   栏中，您可以找到 ![显示工具窗口栏](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.tbShown.svg) 或 ![隐藏工具窗口栏](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.tbHidden.svg) 按钮。 此按钮切换工具窗口栏的可见性。 将鼠标悬停在其上可以查看当前可用工具窗口的列表。

## 编写您的代码

在编辑器中工作时，IntelliJ IDEA 会分析代码并高亮显示问题。 以下功能支持常见的编辑任务:

* [重构](#refactorings)

* [代码补全](#code-completion)

* [正在生成代码](#generating-code)

* [实时模板](#live-templates)

* [检查](#inspections)

* [意图操作](#intention-actions)

Procedure: 重构

[重构](https://en.wikipedia.org/wiki/Code_refactoring) 是在不创建新功能的情况下改进源代码的过程。 重构帮助您保持代码的稳健性、 [dry](https://en.wikipedia.org/wiki/Don%27t_repeat_yourself) 和易于维护。

IntelliJ IDEA 提供以下重构选项：

* [更改签名](change-signature.html)：重命名方法或函数，添加、删除或重新排列参数，并为新的非可变参数分配默认值。

* [提取重构](extract-constant.html)：将代码片段提取为常量、变量、方法或接口，以提高清晰度和可重用性。

* [内联重构](inline.html)：将方法或变量的内容直接移动到其使用的位置。 这是   提取   重构的相反操作。

* [复制重构](move-refactorings.html#copy_refactoring)：将文件、目录或包复制到另一个位置。

* [移动重构](move-refactorings.html#move_refactoring)：将函数、类型或其他代码元素移动到不同的包或文件中，以改善项目结构。

Procedure: 代码补全

IntelliJ IDEA 提供两种代码补全类型：

* 基本 代码补全 `Ctrl+Space` (Windows), `⌃ Space` (macOS), `⌃ Space` (IntelliJ IDEA Classic (macOS)), `⌃ Space` (macOS System Shortcuts), `Ctrl+Space` (XWin), `Ctrl+Space` (GNOME), `Ctrl+Space` (KDE), `Alt+/` (Emacs), `Ctrl+Space` (Sublime Text), `⌃ Space` (Sublime Text (macOS)), `Ctrl+Space` (Visual Studio), `⌃ Space` (Visual Studio (macOS)), `Ctrl+Space` (NetBeans), `Ctrl+Space` (Eclipse), `⌃ Space` (Eclipse (macOS)) 帮助补全当前范围内的类型、接口、方法和关键字的名称。 建议会在您输入时自动出现。

* 智能 代码补全 `Ctrl+Shift+Space` (Windows), `⌃ ⇧ Space` (macOS), `⌃ ⇧ Space` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ Space` (macOS System Shortcuts), `Ctrl+Shift+Space` (XWin), `Ctrl+Shift+Space` (GNOME), `Ctrl+Shift+Space` (KDE), `Ctrl+Shift+Space` (Emacs), `Ctrl+Shift+Space` (Sublime Text), `Ctrl+Shift+Space` (Sublime Text (macOS)), `Ctrl+Alt+Space` (Visual Studio), `⌃ ⌥ Space` (Visual Studio (macOS)), `Ctrl+Shift+Space` (NetBeans), `Alt+Shift+Space` (Eclipse), `⌥ ⇧ Space` (Eclipse (macOS)) 会过滤列表，仅显示适合当前上下文的值。

以下动画演示了基本和智能类型匹配补全之间的区别。 请注意每种类型提供的建议数量：

Procedure: 生成代码

IntelliJ IDEA 提供多种生成常用代码构造和重复元素的方法，帮助您提高生产力。 这些可以是创建新文件时使用的 [文件模板](using-file-and-code-templates.html)、根据上下文不同应用的自定义或预定义 [实时模板](using-live-templates.html)、各种包装器或字符的自动配对。

* 您可以生成 getter、setter、构造器、缺失的方法和测试文件。

Procedure: 实时模板

使用  实时模板  将常用构造插入到代码中，例如循环、条件、声明或 print 语句。

[Video](https://www.youtube.com/v/ffBeoE6NBSs)

* 要查看实时模板列表，请按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 并转到  `编辑器 | 实时代码模板` 。

以下动画展示了如何使用实时模板创建一个  `Hello World`  程序：

Procedure: 检查

在 IntelliJ IDEA 中，有一套代码检查可以在编译项目之前检测和纠正异常代码。 该 IDE 可以查找并高亮显示各种问题，定位无用代码，查找可能的错误、拼写问题，并改善整体代码结构。

[Video](https://www.youtube.com/v/aOLzGQUaTPA)

检查可以扫描所有项目文件中的代码，也可以仅扫描特定 [作用域](configuring-scopes-and-file-colors.html)中的代码（例如，仅扫描生产代码或已修改的文件）。

每项检查都有一个 [严重级别](configuring-inspection-severities.html) — 即问题可能影响代码的程度。 在编辑器中，严重级别会以不同方式高亮显示，以便快速区分关键问题和不太重要的内容。 IntelliJ IDEA 附带一组预定义的严重级别设置，并启用创建自定义严重级别的功能。

* 要查看和配置检查，请按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 并导航到  `编辑器 | 检查` 。 您可以启用或禁用检查，并更改其严重级别。

例如，   不可到达的代码   检查会检测不可达代码。

![无法到达的代码检查](https://resources.jetbrains.com/help/img/idea/2026.3/go_unreachable_code.png)

Procedure: 意图操作

当您在编辑器中工作时，IntelliJ IDEA 会分析您的代码并寻找优化方法。 意图操作涵盖从错误和警告到优化建议的广泛场景。

一旦 IDE 找到改进代码的方法，它会在编辑器中当前行旁边显示一个黄色灯泡图标 ![黄色灯泡图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.codeInsight.intentionBulb.svg)。 点击此图标，可以查看当前上下文中可用的  意图操作 。

要查看可用的意图操作列表，请按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 并导航到  `编辑器 | 意图` 。

1. 点击灯泡图标或按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) 打开建议列表。

2. 从列表中选择一个操作，然后按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。

例如，您可以使用意图操作将另一种语言注入到代码中：

![用意图操作注入一种语言](https://resources.jetbrains.com/help/img/idea/2026.3/调试配置](run-debug-configuration.html) 在 IntelliJ IDEA 中运行和调试代码。

Procedure: 运行您的代码

* 要运行您的应用程序，请按 `Shift+F10` (Windows), `⌃ R` (macOS), `⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ R` (macOS System Shortcuts), `Shift+F10` (XWin), `Shift+F10` (GNOME), `Shift+F10` (KDE), `Shift+F10` (Emacs), `Shift+F10` (Sublime Text), `Shift+F10` (Sublime Text (macOS)), `Ctrl+F5` (Visual Studio), `⌃ F5` (Visual Studio (macOS)), `F6` (NetBeans), `Alt+Shift+X` (Eclipse), `⌘ ⇧ F11` (Eclipse (macOS))，或点击边距中的   运行应用程序   图标 ![运行](https://resources.jetbrains.com/help/img/idea/2026.3/app.toolwindows.toolWindowRun.svg) 并选择   运行 <application_name>  。

![从标记空隙处运行您的代码](https://resources.jetbrains.com/help/img/idea/2026.3/qsg_run_from_gutter.png)

Procedure: 调试您的代码

[调试](debugging-code.html) 从设置断点开始，断点会暂停程序执行，以便您检查程序数据。 要设置断点，请点击边距中您希望执行暂停的行号。

* 要调试您的应用程序，请按 `Shift+F9` (Windows), `⌃ D` (macOS), `⇧ F9` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ D` (macOS System Shortcuts), `Shift+F9` (XWin), `Shift+F9` (GNOME), `Shift+F9` (KDE), `Shift+F9` (Emacs), `Shift+F9` (Sublime Text), `⌃ D` (Sublime Text (macOS)), `Alt+F5` (Visual Studio), `⌥ F5` (Visual Studio (macOS)), `Ctrl+F5` (NetBeans), `Alt+Shift+D` (Eclipse), `⌘ F11` (Eclipse (macOS))，或点击边距中的   运行应用程序   图标 ![运行](https://resources.jetbrains.com/help/img/idea/2026.3/app.toolwindows.toolWindowRun.svg) 并选择   调试 <application_name>  。 然后，使用  `运行`  菜单中的选项或 [调试工具窗口](debug-tool-window.html) 逐步执行。

如需了解更多信息，请参阅 [Debugging](debugging-code.html)。

![调试您的代码](https://resources.jetbrains.com/help/img/idea/2026.3/qsg_go_debug_application.png)

