Горячие клавиши в PhpStorm на Linux: чиним работу в русской раскладке
На Linux сочетания вроде Ctrl+C или Ctrl+Shift+F не срабатывают в PhpStorm, если включена русская раскладка: JVM получает не ту клавишу, что ждёт IDE. Разбираем причины и рабочие способы исправления — от javaagent до настроек Wayland и проверки самомго проекта.
В чём суть проблемы
PhpStorm — Java-приложение (IntelliJ Platform), и клавиатурные события в него приходят через JVM и системный ввод Linux. Когда активна не латинская раскладка, часть окружений передаёт модификаторы или keycode иначе, чем ожидает IDE. В результате Ctrl+C, Ctrl+V, Ctrl+Shift+F и прочие аккорды молча игнорируются, хотя в английской раскладке работают. Исторически это был баг связки «Java + X11 + русская раскладка»: он проявлялся в Ubuntu и других дистрибутивах и не зависел от версии PhpStorm.
Важно не путать это с двумя другими ситуациями: конфликтом горячих клавиш с окружением рабочего стола и не работающими сочетаниями внутри проекта из-за настроек самой IDE. Дальше идём по шагам — от самого вероятного к менее очевидному.
Диагностика: где именно ломается
Прежде чем менять конфиги, зафиксируйте симптомы — это сэкономит время.
- Не работают все аккорды с модификаторами в русской раскладке, но одиночные символы вводятся — типичный признак проблемы JVM/X11, лечится javaagent.
- Не работают только некоторые сочетания — почти всегда конфликт с оконным менеджером (например,
SuperилиAltперехватывает DE). - Не работают аккорды только в одном проекте — смотрите Keymap и установленные плагины, к раскладке это отношения не имеет.
- Сочетания работают в терминале, но не в IDE — проблема на стороне IDE/JVM, а не системы.
Проверьте окружение: X11 или Wayland, какая среда рабочего стола, какая версия JDK идёт в комплекте с IDE.
# сессия и тип сервера
echo "$XDG_SESSION_TYPE"
echo "$DESKTOP_SESSION"
# версия IDE (пример для распакованного архива)
/path/to/PhpStorm/bin/phpstorm.sh --version 2>/dev/null || trueСпособ 1: javaagent для JVM (классическое решение)
Идея в том, чтобы подгрузить в JVM небольшой агент, который нормализует клавиатурные события до того, как их увидит IntelliJ Platform. Такой агент — открытый проект, собранный сообществом; он ставится одной строкой в .vmoptions. Агент совместим с современными сборками JetBrains Runtime, но версию всегда сверяйте с актуальной документацией проекта.
Файл опций лежит рядом с исполняемым файлом IDE: bin/phpstorm64.vmoptions (на 64-битных системах) или bin/phpstorm.vmoptions. Если вы ставили IDE через Toolbox, правьте файл через Help → Edit Custom VM Options — тогда настройки не потеряются при обновлении.
# пример строки в phpstorm64.vmoptions
# путь до JAR-файла агента подставьте свой
-javaagent:/opt/linuxjavafixes/build/LinuxJavaFixes-1.0.0-SNAPSHOT.jarПосле сохранения полностью закройте и запустите IDE заново. Если строка синтаксически неверна или JAR не найден, IDE не стартует — смотрите лог bin/idea.log (или ~/<конфиг>/log/idea.log).
Агент лечит именно X11-сценарий. На Wayland поведение зависит от реализации ввода композитора, поэтому сначала обновите IDE и JBR, а уже потом добавляйте агент.
Способ 2: настройки окружения
Иногда достаточно выровнять настройки ввода — без сторонних JAR.
- Убедитесь, что в системе корректно настроены
XMODIFIERSиGTK_IM_MODULE(для X11 обычно@im=ibusили@im=fcitx). - Проверьте, что IBus/Fcitx запущен и раскладка переключается штатно, а не через скрипт, который ломает состояние модификаторов.
- Для Wayland попробуйте запустить IDE в режиме XWayland (
env -u WAYLAND_DISPLAY /path/to/phpstorm.sh) — часто этого хватает, если композитор не пробрасывает события корректно. - Обновите PhpStorm и встроенную JetBrains Runtime: часть исправлений ввода приходит именно с новыми сборками JBR.
# пример переменных для fcitx в ~/.profile (X11)
export GTK_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitxСпособ 3: Keymap и конфликты с рабочим столом
Если сочетания не работают выборочно, проверьте, не перехватывает ли их оконный менеджер. В GNOME/KDE часть аккордов с Super и Alt зарезервирована системой. Решение — либо переназначить системный аккорд, либо сменить сочетание в IDE.
В PhpStorm откройте Settings → Keymap, найдите проблемное действие и посмотрите, не помечено ли оно конфликтом. Полезно сразу переключить keymap на «GNOME» или «KDE» — там учтены системные резервы.
| Симптом | Вероятная причина | Что делать |
|---|---|---|
| Не работают все Ctrl-аккорды в русской раскладке | JVM/X11 не видит модификатор | javaagent или обновление JBR |
| Не работает конкретное сочетание | Конфликт с оконным менеджером | Переназначить в DE или в Keymap |
| Не работает только в одном проекте | Плагины, макросы, keymap проекта | Отключить плагины, проверить .idea |
| Не работают аккорды в Terminal внутри IDE | Настройки терминала/шелла | Проверить настройки Terminal и профиль шелла |
Что это значит для PHP-разработки
С современным стеком на PHP 8.3–8.5 IDE остаётся основным рабочим инструментом: статический анализ, автодополнение типов, рефакторинг. Если горячие клавиши не работают в русской раскладке, страдает не «удобство», а скорость: переименование переменной, извлечение метода, переход к объявлению становятся многошаговыми. Поэтому проблему стоит закрыть один раз — на уровне JVM/окружения, а не привычкой переключать раскладку перед каждым действием.
Заодно приведите в порядок сам проект — так меньше сюрпризов при рефакторинге:
<?php
declare(strict_types=1);
// Пример: аккуратный value object вместо «магии» из старых проектов
final readonly class Money
{
public function __construct(
public int $amount,
public string $currency,
) {
if ($this->amount < 0) {
throw new InvalidArgumentException('Сумма не может быть отрицательной');
}
}
public function add(self $other): self
{
if ($this->currency !== $other->currency) {
throw new DomainException('Разные валюты');
}
return new self($this->amount + $other->amount, $this->currency);
}
}Старый код с mysql_*, ereg и create_function давно пора заменить: PDO с подготовленными запросами, preg_match и замыкания/стрелочные функции соответственно. Это не связано с раскладкой напрямую, но именно такие места чаще всего трогают через автодополнение и рефакторинг.
Частые вопросы
Агент обязателен на любой Ubuntu?
Нет. На свежих сборках PhpStorm и JetBrains Runtime проблема часто уже не воспроизводится. Сначала обновите IDE и проверьте поведение на чистой конфигурации.
Может ли агент сломать IDE?
Может, если JAR несовместим с версией JBR или указан неверный путь. Тогда IDE не стартует — уберите строку из .vmoptions и запустите снова.
А если я на Wayland?
Начните с обновления IDE и JBR и проверки того, что композитор корректно отдаёт события. Если не помогло — попробуйте запуск через XWayland.
Чек-лист
- Определите тип сессии (
X11/Wayland) и среду рабочего стола. - Обновите PhpStorm и встроенную JetBrains Runtime.
- Проверьте, воспроизводится ли проблема на чистом профиле IDE.
- Для X11 при необходимости добавьте javaagent в
.vmoptionsчерезEdit Custom VM Options. - На Wayland протестируйте запуск через XWayland.
- Убедитесь, что IBus/Fcitx настроены штатно и переменные ввода заданы корректно.
- Проверьте конфликты в
Settings → Keymapи переназначьте системные аккорды. - После любых правок полностью перезапускайте IDE, а не только окно проекта.
Частые вопросы
Почему в PhpStorm на Linux не работают горячие клавиши в русской раскладке?
Чаще всего это особенность связки Java-приложения, X11 и раскладки: JVM получает клавиатурные события в ином виде, чем ожидает IntelliJ Platform. Реже причина в конфликте сочетаний с оконным менеджером или в настройках Keymap конкретного проекта.
Что делает javaagent в .vmoptions и обязателен ли он?
Агент нормализует клавиатурные события до обработки IDE. Он нужен только там, где проблема воспроизводится: на свежих сборках PhpStorm и JetBrains Runtime её часто уже нет, поэтому сначала стоит обновиться.
Как быть, если IDE работает на Wayland?
Начните с обновления PhpStorm и встроенной JetBrains Runtime, проверьте настройки композитора. Если сочетания всё ещё не работают, попробуйте запускать IDE в режиме XWayland.
Агент сломал запуск IDE — что делать?
Уберите строку с -javaagent из .vmoptions (или из пользовательского файла, открытого через Edit Custom VM Options), проверьте путь до JAR и синтаксис строки, затем запустите IDE заново.