PHPTime

Горячие клавиши в 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.

Shell
# сессия и тип сервера
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 — тогда настройки не потеряются при обновлении.

Shell
# пример строки в 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.
Shell
# пример переменных для 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
<?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.

Чек-лист

  1. Определите тип сессии (X11/Wayland) и среду рабочего стола.
  2. Обновите PhpStorm и встроенную JetBrains Runtime.
  3. Проверьте, воспроизводится ли проблема на чистом профиле IDE.
  4. Для X11 при необходимости добавьте javaagent в .vmoptions через Edit Custom VM Options.
  5. На Wayland протестируйте запуск через XWayland.
  6. Убедитесь, что IBus/Fcitx настроены штатно и переменные ввода заданы корректно.
  7. Проверьте конфликты в Settings → Keymap и переназначьте системные аккорды.
  8. После любых правок полностью перезапускайте 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 заново.

Справка по теме

Ещё в разделе «Linux и серверы»

Поиск текста в файлах в Linux: grep, find, ripgrep и примеры для PHP-проекта

Как искать текст в файлах Linux: grep -rn, find с фильтрами по дате, ripgrep для больших проектов. Разбор на примере современного PHP-кода.

5 мин

Сайт на PHP недоступен: пошаговый чек-лист диагностики

Пошаговая диагностика недоступного PHP-сайта: проверяем DNS, TLS, веб-сервер, PHP-FPM, базу данных, свободное место и логи, чтобы найти причину сбоя.

8 мин

Google Drive в Linux: rclone, монтирование, синхронизация и бэкапы сайта

Настройка Google Drive в Linux через rclone: подключение, монтирование, синхронизация и автоматические бэкапы сайта. Практическое руководство для разработчиков.

8 мин

PHP-сайт падает под нагрузкой: как найти причину и настроить PHP-FPM

Как найти причину ошибок 502 и 504 под нагрузкой, рассчитать pm.max_children, настроить OPcache и кеш nginx и проверить результат нагрузочным тестом.

8 мин