Поради та підказки IntelliJ IDEA 1.21.11
Корисна інформація для ефективної обробки та проходження проєкту за допомогою IDE.
WARNING
Ця сторінка написана для версії 1.21.11. Документація для старіших версій може бути неповною.
Ця сторінка надає корисну інформацію, щоб прискорити та полегшити процес розробки. Уключіть їх у свій, на свій смак. Може знадобитися деякий час, щоб освоїти ярлики та інші параметри та звикнути до них. Ви можете використовувати цю сторінку як орієнтир для цього.
WARNING
Призначення клавіш у тексті стосуються типової розкладки IntelliJ IDEA, якщо не вказано інше. Якщо ви використовуєте іншу розкладку клавіатури, зверніться до налаштувань File > Settings > Keymap або знайдіть цю функцію в іншому місці.
Перегляд проєктів
Власноруч
IntelliJ має багато різних способів проходження проєктів. Якщо ви створили джерела за допомогою команд ./gradlew genSources у терміналі або використовували завдання Gradle Tasks > fabric > genSources у вікні Gradle, ви можете вручну переглядати вихідні файли Minecraft у зовнішніх бібліотеках вікна проєкту.
Вихідний код Minecraft можна знайти, якщо ви шукаєте net.minecraft у зовнішніх бібліотеках вікна проєкту. Якщо ваш проєкт використовує розділені джерела з онлайн-генератора шаблона мода, буде два джерела, як зазначено в назві (client/common). Крім того, інші джерела проєктів, бібліотек і залежностей, які імпортуються через файл build.gradle, також будуть доступні. Цей метод часто використовується під час перегляду ресурсів, теґів та інших файлів.
Пошук
Двічі натиснувши Shift, відкриється вікно пошуку. Там ви можете шукати файли та класи вашого проєкту. При активації прапорця include non-project items або натиснувши Shift ще раз двічі, пошук здійснюватиметься не лише в вашому власному проєкті, а й в інших, наприклад у зовнішніх бібліотеках.
Ви також можете використовувати комбінації клавіш ⌘/CTRL+N для пошуку в класах і ⌘/CTRL+Shift+N для пошуку в усіх файлах.
Останнє вікно
Іншим корисним інструментом в IntelliJ є вікно Recent. Ви можете відкрити його за допомогою комбінації клавіш ⌘/CTRL+E. Там ви можете переходити до файлів, які ви вже відвідали, і відкривати вікна інструментів, наприклад структура або закладки.
Код проходження
Перейти до визначення / використання
Якщо вам потрібно перевірити визначення або використання змінних, методів, класів та інших речей, ви можете натиснути ⌘/CTRL+ЛКМ/B, або скористайтеся СКМ (натискання коліщатка миші) на їхніх іменах. Таким чином ви можете уникнути тривалих сеансів прокручування чи посібника пошук визначення, яке знаходиться в іншому файлі.
Ви також можете використовувати ⌘/CTRL+⌥/Shift+ЛКМ/B, щоб переглянути всі реалізації класу чи інтерфейсу.
Закладки
Ви можете робити закладки для рядків коду, файлів або навіть відкритих вкладок редактора. Особливо під час дослідження вихідних кодів це може допомогти позначити місця, які ви хочете швидко знайти знову в майбутньому.
Або натисніть ПКМ по файлу у вікні Project, вкладку редактора або номер рядка у файлі. Створення Мнемонічних закладок дає вам змогу швидко повернутися до цих закладок за допомогою їхніх гарячих клавіш, ⌘/CTRL і цифри, яку ви вибрали для них.
Можна створити кілька списків закладок одночасно, якщо вам потрібно розділити або впорядкувати їх у вікні Bookmarks. Там також буде видно точки зупину.
Аналіз класів
Структура класів
Відкривши вікно Structure (⌘/Alt+7), ви отримаєте огляд свого поточного активного класу. Ви можете побачити, які класи та переліки знаходяться в цьому файлі, які методи були реалізовані та які поля та змінні оголошені.
Іноді це може бути корисним, щоб також активувати опцію Inherited у верхній частині параметрів перегляду під час пошуку потенційних методів для перевизначення.
Ієрархія типів класу
Розмістивши курсор на назві класу та натиснувши ⌘/CTRL+H, ви можете відкрити нове вікно ієрархії типів, у якому показано всі батьківські та дочірні класи.
Утиліта коду
Завершення коду
Завершення коду має бути активовано усталено. Ви автоматично отримуватимете рекомендації під час написання коду. Якщо ви закрили його випадково або просто перемістили курсор у нове місце, ви можете скористатися клавішами ⌘/CTRL+Пробіл, щоб знову відкрити їх.
Наприклад, використовуючи лямбда-вирази, ви можете швидко записати їх за допомогою цього методу.
Генерація коду
Меню генерації можна швидко відкрити за допомогою Alt+Insert (⌘ Command+N у macOS) або перейшовши до Code угорі та вибравши Generate. У файлі Java ви зможете генерувати конструктори, геттери(getters), сетери(setters), перевизначати або реалізовувати методи та багато іншого. Ви також можете генерувати засоби доступу та виклики, якщо у вас установлено плаґін Minecraft Development.
Крім того, ви можете швидко замінити методи за допомогою ⌘/CTRL+O і реалізувати методи за допомогою ⌘/CTRL+I.
У тестовому файлі Java ви зможете створити такі методи тестування, як:
Показ параметрів
Показ параметрів має бути активовано усталено. Під час написання коду ви автоматично отримаєте типи та назви параметрів. Якщо ви закрили їх випадково або просто перемістили курсор у нове місце, ви можете скористатися ⌘/CTRL+P, щоб відкрити їх знову.
Методи та класи можуть мати кілька реалізацій з різними параметрами, також відомі як перевантаження. Таким чином, під час написання виклику методу ви можете вирішити, яку реалізацію ви хочете використовувати.
Рефакторування
Рефакторування — це процес реструктуризації коду без зміни його функціональності під час виконання. Перейменування та безпечне видалення частин коду є частиною цього, але такі речі, як вилучення частин коду в окремі методи та введення нових змінних для повторюваних операторів коду, також називаються «рефакторування».
Багато IDE мають великий набір інструментів, щоб допомогти в цьому процесі. У IntelliJ просто натисніть ПКМ по файлу або частині коду, щоб отримати доступ до доступних інструментів рефакторування.
Особливо корисно звикнути до призначення клавіш інструмента рефакторування перейменування, Shift+F6, оскільки ви, ймовірно, перейменовуєте багато речей у майбутньому. За допомогою цієї функції кожне входження перейменованого коду буде перейменовано та функціонально залишиться незмінним.
Ви також можете переформатувати код відповідно до свого стилю коду. Для цього виберіть код, який потрібно переформатувати (якщо нічого не вибрано, буде переформатовано весь файл) і натисніть ⌘/CTRL+⌥/ALT+L. Щоб змінити спосіб форматування коду IntelliJ, перегляньте параметри у меню File > Settings > Editor > Code Style > Java.
Контекстні дії
Контекстні дії дозволяють рефакторувати певні розділи коду на основі контексту. Щоб скористатися нею, просто перемістіть курсор до області, яку потрібно рефакторувати, і натисніть ⌥/ALT+Enter або натисніть по лампочці зліва. Буде спливне вікно з контекстними діями, які можна використовувати для вибраного коду.
Пошук і заміна вмісту файлу
Іноді для редагування коду потрібні простіші інструменти.
| Призначення клавіш | Функція |
|---|---|
| ⌘/CTRL+F | Знайти в поточному файлі |
| ⌘/CTRL+R | Замінити в поточному файлі |
| ⌘/CTRL+Shift+F | Знайти у більшій області (можна встановити певну маску типу файлу) |
| ⌘/CTRL+Shift+R | Замінити у більшій області (можна встановити певну маску типу файлу) |
Якщо використовуються, усі ці інструменти дозволяють більш конкретне зіставлення шаблону через Regex.
Інші корисні призначення клавіш
Виділення тексту та використання ⌘/CTRL+Shift+↑ Угору / ↓ Униз може перемістити виділений текст угору або вниз.
В IntelliJ сполучення клавіш для Redo може бути не звичайним ⌘/CTRL+Y (Видалити рядок). Натомість це може бути ⌘/CTRL+Shift+Z. Ви можете змінити це в Keymap.
Ще більше призначень клавіш можна знайти в документації 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 і може повідомити вас, якщо ви зафіксуєте код, який використовує такі типи коментарів.
Javadocs
Чудовим способом документування вашого коду є використання JavaDoc. JavaDocs не тільки надає корисну інформацію для реалізації методів і класів, але й глибоко інтегровано в IntelliJ.
При наведенні курсора на імена методів або класів, до яких додано коментарі JavaDoc, вони показуватимуть цю інформацію у своєму інформаційному вікні.
Щоб почати, просто напишіть /** над визначенням методу або класу та натисніть Enter. IntelliJ автоматично згенерує рядки для значення, що повертається, і параметрів, але ви можете змінити їх як завгодно. Доступно багато спеціальних функцій, і ви також можете використовувати HTML, якщо потрібно.
У класі ScreenHandler Minecraft є кілька прикладів. Щоб перемкнути перегляд рендера, використовуйте кнопку пера біля номерів рядків.
Перегляд байт-коду
Перегляд байт-коду необхідний під час написання міксинів. Ви можете переглянути байт-код класу бібліотеки (наприклад, класу Minecraft), відкривши клас у редакторі, а потім вибравши Show Bytecode у меню View.
Подальша оптимізація IntelliJ
Є багато інших ярликів і зручних хитрощів, які виходять за рамки цієї сторінки. Jetbrains має багато хороших доповідей, відео та сторінок документації про те, як ще більше налаштувати робочий простір.
Завершення PostFix
Використовуйте PostFix Completion, щоб змінити код після його швидкого написання. Часто використовувані приклади містять .not, .if, .var, .null, .nn, .for, .fori, .return та .new. Крім наявних, ви також можете створити власні в налаштуваннях IntelliJ.
Живі шаблони
Використовуйте живі шаблони, щоб швидше генерувати власний шаблонний код.
Більше порад і підказок
Антон Архипов з Jetbrains також детально розповів про зіставлення регулярних виразів, завершення коду, налагодження та багато інших тем в IntelliJ.
Для отримання додаткової інформації відвідайте сайт Jetbrains з порадами та підказками і документацію IntelliJ. Більшість їхніх публікацій також стосуються екосистеми Fabric.