Текст и данные · Инструкция
Settings Sync в VS Code: включение и настройка
Settings Sync в VS Code переносит между компьютерами привычную конфигурацию редактора: настройки, сочетания клавиш.
Короткий ответ
Чтобы включить Settings Sync, откройте меню Accounts или шестерёнку Manage → Backup and Sync Settings…, войдите через Microsoft или GitHub и отметьте, что синхронизировать. На втором компьютере включите Sync тем же аккаунтом и внимательно выберите Merge или Replace Local.
Что синхронизирует Settings Sync и чего он не переносит
Settings Sync предназначен для конфигурации самого Visual Studio Code. Официальная документация перечисляет настройки, сочетания клавиш, пользовательские snippets, user tasks, UI State, расширения и Profiles. Это удобно, если вы работаете на домашнем и рабочем компьютере или периодически переустанавливаете систему: после входа редактор постепенно восстанавливает привычную среду.
При этом Sync не является резервной копией репозиториев и не копирует исходники проекта. Он также не должен восприниматься как замена Git. Машинно-зависимые настройки с областью `machine` или `machine-overridable` по умолчанию не синхронизируются, потому что абсолютные пути, локальные SDK и системные параметры на разных компьютерах могут отличаться.
Есть ещё важное ограничение для удалённой разработки: Microsoft указывает, что расширения не синхронизируются в Remote Window, когда вы подключены к SSH, Dev Container или WSL. Локальная конфигурация и удалённая среда существуют раздельно. Поэтому после включения Sync всё равно может потребоваться поставить языковой сервер или инструмент непосредственно на удалённую сторону.
Как включить Settings Sync на первом компьютере
- Откройте меню Accounts в нижней части Activity Bar или меню Manage с шестерёнкой и выберите Backup and Sync Settings….
- Выберите, какие категории переносить. Если не хотите тащить все расширения или горячие клавиши, снимите ненужные пункты до первой синхронизации.
- Нажмите Sign in и выберите Microsoft либо GitHub. Браузер откроет страницу авторизации; завершите вход тем аккаунтом, который будете использовать и на других устройствах.
- Вернитесь в VS Code. После успешной авторизации синхронизация включается и дальше работает автоматически в фоне.
- Откройте команду `Settings Sync: Configure`, если позже понадобится изменить набор синхронизируемых данных.
- Для проверки используйте `Settings Sync: Show Synced Data`: там можно посмотреть синхронизированные ресурсы и их версии.
Что выбрать на втором компьютере: Merge, Replace Local или ручное слияние
Самый рискованный момент возникает не на первой машине, а на второй, где уже есть собственные настройки. VS Code может предложить Merge or Replace. `Merge` объединяет локальные данные с облачными. `Replace Local` заменяет локальную конфигурацию тем, что хранится в Sync. Для чистой новой установки Replace Local часто логичен, но на давно настроенной рабочей машине он способен затереть полезные локальные значения.
Если конфигурации расходятся существенно, безопаснее выбрать ручное сравнение. При конфликтах VS Code умеет показать diff и предложить Accept Local, Accept Remote или просмотр различий. Это особенно полезно для `settings.json` и сочетаний клавиш: одна строка с путём или shell может быть правильной только на конкретной ОС.
Перед выбором посмотрите, какие настройки действительно должны быть одинаковыми. Цветовая тема, formatter и общие editor-настройки обычно хорошо переносятся. Абсолютные пути, специальные терминалы и локальные SDK лучше держать машинно-зависимыми. Такой подход снижает число конфликтов и делает Sync предсказуемым между Windows, macOS и Linux.
Предупреждение: Если сомневаетесь между Merge и Replace Local, сначала сделайте резервную копию локальных настроек и используйте ручное сравнение. Возврат после неудачной замены сложнее.
Какие данные синхронизировать, а какие лучше исключить
| Категория | Обычно синхронизировать | Когда ограничить |
|---|---|---|
| Settings | Да | Если много локальных путей и ОС-зависимых параметров |
| Keyboard Shortcuts | Да | Если раскладки и сочетания сильно отличаются между ОС |
| Extensions | Да | Если рабочие роли на машинах разные |
| Profiles | Да | Удобно для отдельных стеков и сценариев |
| User snippets | Да | Обычно безопасно и полезно |
| User tasks | По ситуации | Команды могут зависеть от локальных инструментов |
Как исключить настройки или расширения из синхронизации
Settings Sync не требует переносить всё подряд. Для параметров есть `settingsSync.ignoredSettings`, куда можно добавить идентификаторы настроек, которые должны оставаться локальными. Это полезно для путей к SDK, специфических терминалов, прокси или любых значений, различающихся по устройствам. Некоторые machine-scoped параметры уже не синхронизируются по умолчанию.
Расширения тоже можно исключать. В Extensions для конкретного пакета доступна настройка, позволяющая не синхронизировать его, а список отражается в `settingsSync.ignoredExtensions`. Практический пример — тяжёлое расширение, нужное только на рабочем ноутбуке, или инструмент, который конфликтует с корпоративным окружением на другой машине.
Сочетания клавиш по умолчанию синхронизируются с учётом платформы. Если ваши shortcuts специально сделаны одинаковыми на всех ОС, Microsoft позволяет отключить `settingsSync.keybindingsPerPlatform`. Но делать это стоит осознанно: Ctrl, Cmd и системные комбинации отличаются, и перенос «один в один» может создать конфликт с операционной системой.
Совет: Исключение одной настройки обычно лучше, чем отключение Sync целиком: оставьте общие параметры облачными, а локальные различия — локальными.
Как восстановиться после конфликта или неудачной синхронизации
- Откройте `Settings Sync: Show Synced Data` и посмотрите историю нужного ресурса вместо ручного восстановления по памяти.
- Проверьте Local и Remote варианты конфликтующего файла через diff-редактор.
- Если проблема появилась после подключения новой машины, сначала остановите изменения на ней и разберите конфликт, чтобы не размножать ошибочную конфигурацию.
- Используйте команду открытия локальных backup-файлов Sync, если нужно вернуть прежний вариант.
- Помните, что локальные резервные копии Sync не вечны: официальная документация указывает автоматическое удаление локальных backup после 30 дней, поэтому важную корпоративную конфигурацию храните дополнительно.
- При смене аккаунта сначала выключите Sync, затем включите его снова под нужной учётной записью.
Что учитывать
Условия меняются. Страница отражает состояние на 2026-09-20; при расхождении с официальной документацией приоритет у первоисточника.
Источники и проверка
Фактическая часть сверена по первичным источникам (в т.ч. Settings Sync). Пример и формулировки — редакция N1RO на 2026-09-20.