Русский
Как использовать кнопки мыши в VS Code на Mac
Это приложение полностью бесплатное. Создавать учётную запись не нужно. Нет подписок, нет сложных загрузок, и ничего не заблокировано. Оптимизировано для Apple Silicon.
VS Code уже считает боковые кнопки назад и вперёд, а встроенный способ сделать это на Mac: настройка, а не переназначатель. Переназначатель добавляет запуск, сборку, остановку и шаги отладчика, то есть клавиши на кнопке. InputConfig, бесплатное приложение для Mac, которое я делаю, сканирует любую кнопку мыши и посылает клавишу или целое сочетание, и может следовать за VS Code как приложением впереди. Это приложение полностью бесплатно, и создавать учётную запись не нужно.
Клавиши взяты из листа клавиатурных сочетаний macOS Microsoft, страницы про отладку и страницы про задачи, прочитанных 21 октября 2026 года. Раздел про Xcode ниже использует собственный список Apple.
Шаги
- В VS Code найдите в Settings слова mouse back forward и проверьте, что включена настройка Enables the use of mouse buttons four and five.
- Установите InputConfig и разрешите доступ в Системных настройках, Конфиденциальность и безопасность, Универсальный доступ.
- Добавьте строку, задайте ввод Mouse, нажмите Scan (Сканировать) и щёлкните большую кнопку, затем выберите Keyboard Key и сочетание для запуска или сборки.
- Не добавляйте VS Code в пресет, который посылает Command левую или правую квадратную скобку, потому что они отступают и снимают отступ строк.
- Добавьте VS Code в пункт Activate when these apps are in front (Включать, когда эти приложения на переднем плане), включите Switch presets when the front app changes и нажмите Activate.
Что дают VS Code и macOS мыши
В VS Code есть настройка workbench.editor.mouseBackForwardToNavigate, которая в исходном коде описана как включение кнопок мыши 4 и 5 для команд Go Back и Go Forward, и по умолчанию она включена. Это взято из исходного кода VS Code на GitHub, прочитанного 21 октября 2026 года. Мышь, у которой боковые кнопки определяются как Button 4 и Button 5, должна поэтому переходить без помощи.
Клавиатурные аналоги: Control минус для Go Back и Control Shift минус для Go Forward из листа Microsoft. Если боковые кнопки уже переходят в VS Code, оставьте их в покое, а переназначатель используйте для кнопок, которые ничего не делают.
Выясните, что посылает каждая кнопка
Кнопка мыши попадает на Mac как Left click, Right click, Middle click или Button 4 и выше. Нажмите Scan, затем щёлкните кнопку. Если Scan называет клавишу вместо кнопки мыши, мышь посылает клавишу, и решение находится на странице F13 до F19 на Mac.
| Кнопка | Как обычно передаётся | Хорошая задача в VS Code |
|---|---|---|
| Левый и правый клик | Left click и Right click | Оставьте. Их нельзя заблокировать. |
| Нажатие на колесо | Middle click | Закрыть редактор, Command W, или Go to Definition, F12. |
| Боковые кнопки | Button 4 и Button 5 | Назад и вперёд, которые VS Code, возможно, уже делает. |
| Сетка больших пальцев или дополнительные кнопки | Клавиши, обычно цифровой ряд, у большинства MMO-мышей. Остальные дополнительные кнопки приходят как Button 6 и выше, в пункте «Больше кнопок». | Run, Stop, Step over, Step into, Build. |
| Наклон колеса | Scroll X (Прокрутка X), горизонтально | Предыдущая и следующая вкладка редактора. |
| Кнопка DPI или профиля | Часто ничего, что Mac может прочитать | Ничего. Если Scan не слышит нажатия, никакое приложение его не прочитает. |
Если кнопка кажется неживой, один раз запустите тестер мыши, прежде чем искать причину в назначении. Кнопка, которая там загорается, доходит до Mac, и проблема дальше.
Ловушка скобок Command
В InputConfig есть встроенный пресет, который ставит назад и вперёд на боковые кнопки, посылая Command левую квадратную скобку и Command правую квадратную скобку, которые понимают браузеры и Finder. В VS Code по листу Microsoft те же две клавиши означают отступ и снятие отступа строки. Если этот пресет работает, пока VS Code впереди, нажатие боковой кнопки меняет ваш код.
- Вариант первый. Оставьте боковые кнопки настройке самого VS Code и держите этот пресет для других приложений.
- Вариант второй. Создайте пресет для VS Code, который посылает Control минус и Control Shift минус на те же кнопки, и добавьте VS Code в пункт Activate when these apps are in front.
- Вариант третий. Отметьте Block the button's own action (Блокировать собственное действие кнопки) в строках, если действуют и VS Code, и пресет, чтобы «назад» не срабатывало дважды.
Одновременно работает только один пресет, поэтому пресету для VS Code и пресету назад и вперёд нужны собственные списки приложений. Одни и те же две кнопки должны посылать разные клавиши в разных приложениях, и для этого существуют пресеты для отдельных приложений.
Поставьте запуск, сборку и отладчик на кнопки
Шаг 1: нажмите Scan и назначьте запуск
- Вы: Добавьте строку, задайте устройство This Mac's mouse or trackpad, ввод Mouse и тип Button, затем нажмите Scan и щёлкните кнопку на большом пальце. Задайте выход Keyboard Key (Клавиша клавиатуры) и выберите F5.
- InputConfig: Нажимает F5 каждый раз, когда вы нажимаете кнопку.
- Проверка: Откройте проект с настройкой запуска и нажмите кнопку. Отладчик стартует или продолжает работу, если уже запущен.
Шаг 2: добавьте сборку и остановку
- Вы: На следующей кнопке задайте выход Keyboard Key, выберите Shift и Command в Modifier Keys (Клавиши-модификаторы) и добавьте B. На другой кнопке Shift и F5.
- InputConfig: Нажимает Shift Command B, которое использует Run Build Task, и Shift F5, которое останавливает отладку.
- Проверка: Нажмите сборку, и запустится задача по умолчанию или выбор задачи. Нажмите остановку, и отладка закончится.
| Задача | Клавиша VS Code на Mac | Хорошее место |
|---|---|---|
| Go Back и Go Forward | Control минус и Control Shift минус | Button 4 и Button 5 |
| Запуск или продолжение отладки | F5 | Кнопка на большом пальце |
| Остановка отладки | Shift F5 | Удержание на той же кнопке |
| Перезапуск отладки | Shift Command F5 | Второе удержание |
| Run Build Task | Shift Command B | Кнопка на большом пальце |
| Step over, into, out | F10, F11 и Shift F11 | Три кнопки на большом пальце |
| Переключить точку останова | F9 | Кнопка на большом пальце |
| Go to Definition и Peek Definition | F12 и Option F12 | Нажатие на колесо и удержание |
| Quick Open и Command Palette | Command P и Shift Command P | Две кнопки на большом пальце |
| Показать встроенный терминал | Control backtick | Кнопка на большом пальце |
| Закрыть редактор | Command W | Нажатие на колесо |
Страница отладки VS Code перечисляет F5 как продолжить или приостановить, а Shift F5 как остановить. Run Build Task вызывается через Shift Command B по странице задач.
Макросы и многошаговые задачи
Макрос представляет собой строку с отмеченным пунктом Run a sequence of steps, и каждый шаг представляет собой клавишу, сочетание или клик с собственным ожиданием. Три варианта, которые подходят для кода:
- Сохранить, затем собрать. Command S, короткое ожидание, затем Shift Command B. Сохраняется открытый файл, и запускается сборка.
- Остановить и запустить снова. Shift F5, пауза в секунду, затем F5. Повторный запуск на одной кнопке.
- Терминал под рукой. Control backtick показывает встроенный терминал, затем выход Type Text (Ввести текст) может напечатать команду, которую вы запускаете весь день. Лучше оставить Return выключенным, чтобы сначала проверить команду.
Эти макросы в VS Code не проверялись, поэтому макрос, который останавливает и запускает отладчик, стоит сначала проверить. Не добавляйте Return в набранную команду, чтобы случайное нажатие её не запустило.
Нажатие и удержание, повтор и переключение по приложению
- Нажатие и удержание. F5 по нажатию и Shift F5 при удержании, так что одна кнопка запускает и останавливает. Короткое нажатие посылает обычный выход, а удержание дольше заданного времени посылает что-то другое.
- Повтор клавиш при удержании. Для шагов клавишей F10 это продолжает шаги, пока кнопка удержана. Для сборки оставьте выключенным.
- Блокировать собственное действие кнопки. Доступно для средней кнопки и боковых кнопок, так что приложение перестаёт их видеть, пока пресет работает.
Чтобы раскладка оставалась в VS Code, откройте раздел Automation & Gaming Utilities (Автоматизация и игровые утилиты) пресета, добавьте Visual Studio Code в пункт Activate when these apps are in front и в настройках, Advanced, включите Switch presets when the front app changes.
Xcode на Mac
В Xcode та же идея с другими клавишами. Таблица Apple в архиве перечисляет их в архивном списке команд меню Xcode от Apple, прочитанном 21 октября 2026 года. Она описывает более старый Xcode, поэтому откройте меню Product и Navigate в своей версии, где каждая команда показывает текущую клавишу.
| Задача | Клавиша Xcode из таблицы Apple | Хорошее место |
|---|---|---|
| Go Back и Go Forward | Control Command Left Arrow и Control Command Right Arrow | Button 4 и Button 5 |
| Run | Command R | Кнопка на большом пальце |
| Build | Command B | Кнопка на большом пальце |
| Stop | Command period | Удержание на Run |
| Open Quickly | Shift Command O | Нажатие на колесо |
| Clean | Shift Command K | Удержание на Build |
Дайте Xcode собственный пресет и добавьте его в пункт Activate when these apps are in front. Назначьте кнопки, взяв клавиши из меню Xcode, и Xcode никогда не увидит клавиш VS Code. Run и Stop на удержании одной кнопки дают самый простой способ управлять любым из редакторов.
Если кнопка ничего не делает в VS Code
Проверяйте по порядку, начиная с самого простого шага:
- Проверьте, что пресет включён. Нажмите Activate (Включить) и убедитесь, что пресет следует за VS Code.
- Проверьте «Универсальный доступ». Системные настройки, Конфиденциальность и безопасность, Универсальный доступ.
- Проверьте двойное действие. Если «назад» срабатывает дважды, настройка самого VS Code и ваша строка действуют вместе. Отметьте Block the button's own action.
- Проверьте функциональные клавиши. F5 и F10 на ноутбуке могут требовать клавишу Fn. Задайте в Системных настройках, Клавиатура, стандартную работу функциональных клавиш или посылайте клавишу из строки, которая от этого не зависит.
- Проверьте Scan. Если кнопка определяется как клавиша, сначала задайте ей F13 до F20 в программе производителя.
- Закройте программу производителя. Logi Options+ и похожие приложения могут перехватить кнопку раньше, чем её увидит VS Code.
Чего это не умеет
- Читать ваш код. InputConfig посылает клавиши, клики и прокрутку. Он не знает, какой файл или состояние отладчика открыты.
- Различать две мыши. Каждая подключённая мышь считается одним устройством.
- Менять скорость указателя. Используйте настройки Mac, программу производителя или LinearMouse, Mac Mouse Fix или SteerMouse.
- Работать только в одном проекте. Пресет следует за приложением впереди, а не за папкой или рабочей областью.
Коротко
- Сначала проверьте настройку. VS Code может сам переходить по Button 4 и Button 5.
- Избегайте клавиш со скобками. Command левая и правая квадратные скобки отступают строки в VS Code.
- Следуйте за приложением. У VS Code и Xcode свои пресеты.
Первым стоит попробовать запуск по нажатию и остановку по удержанию на одной кнопке большого пальца.
Вопросы
Можно ли использовать кнопки назад и вперёд мыши в VS Code на Mac?
Да. В VS Code есть настройка, которая назначает кнопки мыши 4 и 5 на Go Back и Go Forward, и по её исходному коду она включена по умолчанию. Клавиши на клавиатуре: Control минус и Control Shift минус.
Почему кнопка назад мыши отступает строки в VS Code?
Пресет посылает Command левую или правую квадратную скобку, которыми VS Code отступает и снимает отступ. Используйте пресет для VS Code, который вместо этого посылает Control минус.
Какие сочетания VS Code для запуска и сборки на Mac?
F5 запускает или продолжает отладку, Shift F5 останавливает, а Shift Command B запускает задачу сборки.
Как запускать код в VS Code кнопкой мыши?
Нажмите Scan для кнопки в InputConfig, задайте выход Keyboard Key и выберите F5. Добавьте действие при удержании Shift F5, чтобы та же кнопка останавливала отладку.
Какое сочетание Xcode для возврата назад на Mac?
Control Command Left Arrow по таблице Apple, а Control Command Right Arrow идёт вперёд. Проверьте свои меню Xcode, потому что таблица из более старой версии.
Ещё на русском
Кто это пишет. Ryleigh Newman разрабатывает InputConfig и каждый день управляет своим Mac с помощью геймпада, потому что руки плохо слушаются. Эта страница переведена с английского. Если на Mac выбран русский язык, InputConfig показывается по-русски. Некоторые страницы сайта пока есть только на английском.
Эта страница на других языках: English, 简体中文
Бесплатно. macOS 14 или новее. Без учётной записи, ничего не покидает ваш Mac. Исходный код на GitHub.