IntelliJ IDEA 提示和技巧

本页面提供一些有用的信息，加速并简化开发者的工作流程。根据你的喜好自由发挥到你的项目中。学习并习惯这些捷径和其他选项可能会花点时间。你可以以此页面作为参考。

WARNING

如果没有特别说明，本文中的按键映射均指 IntelliJ IDEA 的默认按键映射预设。如果你所使用的是不同的键盘布局，请参考 文件 > 设置 > 按键映射 设置，或直接搜索对应功能。

遍历项目

手动

IntelliJ 有许多不同的方式来遍历项目。如果你已使用终端中的 ./gradlew genSources 命令生成源代码或在 Gradle 窗口中使用了 Tasks > fabric > genSources Gradle 任务，则可以在项目窗口的外部库中手动浏览 Minecraft 的源文件。

在项目窗口的外部库查找 net.minecraft 即可找到 Minecraft 源代码。如果你的项目使用了在线模板模组生成器中的分离源码集，则会有两个分开的源代码(client/common）。此外，通过 build.gradle 文件导入的其他项目源、库和依赖也将可用。这种方法常用于浏览资源文件、标签和其他文件。

搜索

按两次 Shift 键可打开“搜索”窗口。你可以在其中搜索项目的文件和类。当激活复选框 包括非项目条目 或再次按两次 Shift 时，搜索不仅会查找你自己的项目，还会查找其他项目，例如外部库。

你还可以使用快捷键 ⌘/CTRL + N 来搜索类，以及使用快捷键 ⌘/CTRL + Shift + N 搜索所有_文件_。

遍历代码

跳转至定义/用法

如果你需要查看变量、方法、类和其他内容的定义或用法，可以按 ⌘/CTRL + 左键单击/B 或在其名称上使用鼠标中键（按下鼠标滚轮）。这样，你就可以避免长时间滚动会话或手动搜索位于另一个文件中的定义。

你还可以使用 ⌘/CTRL + ⌥/Shift + 左键单击/B 查看某个类或接口的所有实现。

书签

你可以为代码行、文件甚至打开的“编辑器”选项卡添加书签。特别是在研究源代码时，书签可以帮助你标记将来想要再次快速找到的位置。

右键单击 项目 窗口、编辑器选项卡或文件中的行号中的文件。创建助记书签使你能够使用其热键 ⌘/CTRL 和你为其选择的数字快速切换回这些书签。

如果你需要分离或排序书签列表，可以在书签窗口中同时创建多个书签列表。断点也将显示在那里。

分析类

类的结构

打开结构窗口（⌘/Alt + 7），可以获得当前活动类的概览。你可以看到该文件中有哪些类和枚举、实现了哪些方法以及声明了哪些字段和变量。

有时，在寻找可能要覆盖的方法时，在“视图”选项顶部激活继承选项也会很有帮助。

类的类型层次结构

将光标放在类名上并按 ⌘/CTRL + H，可以打开一个新的类型层次结构窗口，其中显示所有父类和子类。

代码实用工具

代码补全

代码补全应默认激活。你将在编写代码时自动获得建议。如果你不小心把它关闭了或者不慎将光标移动到了新位置，可以使用 ⌘/CTRL + 空格 重新打开。

例如，当使用 lambda 表达式时，你可以使用这种方法快速编写。

代码生成

可以通过 Alt + Insert（在 macOS 上为 ⌘ Command + N）快速访问生成菜单，或者转到顶部的 代码 并选择 生成。在 Java 文件中，你可以生成构造器、getter、setter、重写或实现方法，等等。如果安装了 Minecraft Development 插件，你还可以生成访问器和调用器。

此外，你可以使用 ⌘/CTRL + O 快速重写方法，并使用 ⌘/CTRL + I 实现方法。

在 Java 测试文件中，会有选项生成相关的测试方法，就像下面这样：

显示参数

显示参数应默认激活。你将在编写代码时自动获取参数的类型和名称。如果你意外把它关闭了或者不慎将光标移动到了新位置，可以使用 ⌘/CTRL + P 再次打开。

方法和类可以有具有不同参数的多个实现，也称为“重载”。这样，你可以在编写方法调用时决定要使用哪种实现。

重构

重构是在不改变代码运行时功能的情况下重组代码的过程。安全地重命名和删除部分代码是其中的一部分，但将部分代码提取到单独的方法中以及为重复的代码语句引入新变量等操作也称为“重构”。

许多 IDE 都有丰富的工具包来帮助完成这一过程。在 IntelliJ 中，只需右键单击文件或部分代码即可访问可用的重构工具。

习惯重命名重构工具的按键绑定 Shift+F6 特别有用，因为你将来可能会重命名很多东西。使用这一功能，重命名的代码中每次出现的地方都会被重命名，并保持功能不变。

你还可以根据你的代码风格重新格式化代码。要这么做，请选择要重新格式化的代码（如果未选择任何内容，则将重新格式化整个文件）并按 ⌘/CTRL + ⌥/ALT + L。要更改 IntelliJ 格式化代码的方式，参见 文件 > 设置 > 编辑器 > 代码风格 > Java 中的设置。

上下文操作

上下文操作允许根据上下文重构特定代码段。要使用它，只需将光标移动到要重构的区域，然后按 ⌥/ALT + Enter 或者单击左侧的灯泡。将出现一个弹出窗口，会显示所选代码可用的上下文操作。

查找和替换文件内容

有时需要用更简单的工具来编辑代码出现的各个地方。

按键绑定	功能
`⌘/CTRL` + `F`	在当前文件中查找
`⌘/CTRL` + `R`	在当前文件中替换
`⌘/CTRL` + `Shift` + `F`	在更大的范围内查找（可以设置特定的文件类型掩码）
`⌘/CTRL` + `Shift` + `R`	在更多的范围内替换（可以设置特定的文件类型掩码）

如果使用，所有这些工具都允许通过正则表达式进行更具体的模式匹配。

其他有用的按键绑定

选择一些文本并使用⌘/CTRL+Shift+↑ 上 / ↓ 下可以将选择的文本向上或者向下移动。

在 IntelliJ 中，“重做”的按键绑定不是常用的⌘/CTRL+Y（删除行），相反地，它可能是 ⌘/CTRL+Shift+Z 可以在按键映射中修改。

键盘快捷键的更多信息，可见 IntelliJ 的文档。

注释

好的代码应该可读并且是自解释的。变量、类、方法选择能清晰表达的名称，这会很有帮助，但有时也需要用注释来留下记录，或者暂时把代码禁用以做测试。

要更快地将代码注释掉，可以选择一些文本，并使用⌘/CTRL+/（行注释）和⌘/CTRL+⌥/Shift+/（块注释）按键绑定。

现在你可以高亮必要的代码（或者只是鼠标指在上面），并使用快捷键将这一段注释掉。

java

// private static final int PROTECTION_BOOTS = 2;
private static final int PROTECTION_LEGGINGS = 5;
// private static final int PROTECTION_CHESTPLATE = 6;
private static final int PROTECTION_HELMET = 1;

java

/*
ModItems.initialize();
ModSounds.initializeSounds();
ModParticles.initialize();
*/

private static int secondsToTicks(float seconds) {
    return (int) (seconds * 20 /*+ 69*/);
}

代码折叠

在 IntelliJ 中，在行号旁边，可能会看到小的箭头图标。这些可以用于暂时折叠方法、if-语句、类和很多其他东西，如果这些你并不是正在处理这些。要创建自定义的可以被折叠的块，使用 region 和 endregion 注释。

java

// region collapse block name
    ModBlocks.initialize();
    ModBlockEntities.registerBlockEntityTypes();
    ModItems.initialize();
    ModSounds.initializeSounds();
    ModParticles.initialize();
// endregion

WARNING

如果你发现这些用太多了，考虑重构你的代码从而让它更加可读。

禁用格式化器

注释还可以在上述代码重构期间禁用格式化程序，方法是像这样围绕一段代码：

java

//formatter:off (disable formatter)
    public static void disgustingMethod() { /* ew this code sucks */ }
//formatter:on (re-enable the formatter)

禁止检查

//noinspection 注释可用于禁止检查和警告。它们在功能上与 @SuppressWarnings 注释相同，但没有注释的限制，并且可以在语句上使用。

java

// below is bad code and IntelliJ knows that

@SuppressWarnings("rawtypes") // annotations can be used here
List list = new ArrayList();

//noinspection unchecked (annotations cannot be here so we use the comment)
this.processList((List<String>)list);

//noinspection rawtypes,unchecked,WriteOnlyObject (you can even suppress multiple!)
new ArrayList().add("bananas");

WARNING

如果你注意到你禁止了太多警告，请考虑重写代码以免产生太多警告！

TODO 和 FIXME 注释

写代码时，把需要关心的东西留下注释也是很方便的。有时你可以也注意到代码中有潜在的问题，但是不想停下当前的事情去关注这个问题。这时，可以使用 TODO 或 FIXME 注释。

IntelliJ 会在 TODO 窗口中跟踪，并如果在提交使用了这些类型的注释的代码时提醒你。

Javadoc

给你的代码写文档最好的方式是使用 JavaDoc。 JavaDoc 不仅提供方法和类的实现的有用信息，还能与 IntelliJ 深度融合。

当鼠标悬念在有添加了 JavaDoc 注释的方法或类名上时，信息窗口中会显示这个信息。

要开始写，先在方法或类的定义上方写上 /**，然后按 Enter。 IntelliJ 会自动为返回值及各参数生成行，但你也可以随意改变。有很多可用的自定义功能，还可以在需要时使用 HTML。

Minecraft 的 ScreenHandler 类有些例子。要开启渲染视图，可使用行号旁边的笔按钮。

查看字节码

在编写 mixins 时，查看字节码是必要的。你可以通过在编辑器中打开一个库类（例如 Minecraft 类），然后在 View 菜单中选择 Show Bytecode 来查看该类的字节码。

进一步优化 IntelliJ

还有很多捷径和便捷的小技巧，这个页面没有提到。 Jetbrains 有很多关于如何进一步个性化你的工作空间的讨论、视频和文档页面。

后缀补全

写了代码后，可以用后缀补全来快速修改。常用的一些例子有 .not、.if、.var、.null、.nn、.for、.fori、.return 和 .new。除了这些已有的之外，你也可以在 IntelliJ 的设置中创建你自己的。

实时模板

使用实时模板可以更快地生成自定义样板代码。

创建你的第一个物品

方块实体

模型生成

世界生成

移植到 26.1

迁移映射

页面作者

源代码和资源

页面作者

IntelliJ IDEA 提示和技巧

遍历项目

手动

搜索

最近窗口

遍历代码

跳转至定义/用法

书签

分析类

类的结构

类的类型层次结构

代码实用工具

代码补全

代码生成

显示参数

重构

上下文操作

查找和替换文件内容

其他有用的按键绑定

注释

代码折叠

禁用格式化器

禁止检查

TODO 和 FIXME 注释

Javadoc

查看字节码

进一步优化 IntelliJ

后缀补全

实时模板

更多提示和技巧

页面作者

源代码和资源

页面作者

IntelliJ IDEA 提示和技巧 ​

遍历项目 ​

手动 ​

搜索 ​

最近窗口 ​

遍历代码 ​

跳转至定义/用法 ​

书签 ​

分析类 ​

类的结构 ​

类的类型层次结构 ​

代码实用工具 ​

代码补全 ​

代码生成 ​

显示参数 ​

重构 ​

上下文操作 ​

查找和替换文件内容 ​

其他有用的按键绑定 ​

注释 ​

代码折叠 ​

禁用格式化器 ​

禁止检查 ​

TODO 和 FIXME 注释 ​

Javadoc ​

查看字节码 ​

进一步优化 IntelliJ ​

后缀补全 ​

实时模板 ​

更多提示和技巧 ​

IntelliJ IDEA 提示和技巧

遍历项目

手动

搜索

最近窗口

遍历代码

跳转至定义/用法

书签

分析类

类的结构

类的类型层次结构

代码实用工具

代码补全

代码生成

显示参数

重构

上下文操作

查找和替换文件内容

其他有用的按键绑定

注释

代码折叠

禁用格式化器

禁止检查

TODO 和 FIXME 注释

Javadoc

查看字节码

进一步优化 IntelliJ

后缀补全

实时模板

更多提示和技巧