Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы может все еще выполняться. Актуальные сведения см. в документации на английском языке.

Веб-редактор github.dev

Вы можете использовать веб-редактор github.dev для редактирования файлов и фиксации изменений.

Примечание: Редактор github.dev в настоящее время находится в бета-версии предварительной версии. Вы можете оставить отзыв в наших обсуждениях.

Сведения о редакторе github.dev

Редактор github.dev предоставляет упрощенный интерфейс редактирования, который полностью выполняется в браузере. С помощью редактора github.dev можно перемещаться по файлам и репозиториям исходного кода из GitHub, а также вносить и фиксировать изменения кода. В редакторе можно открыть любой репозиторий, вилку или запрос на вытягивание.

Редактор github.dev доступен всем бесплатно в GitHub.com.

Редактор github.dev предоставляет множество преимуществ Visual Studio Code, таких как поиск, выделение синтаксиса и представление системы управления версиями. Также вы можете с помощью синхронизации параметров передать в редактор собственные настройки VS Code. Дополнительные сведения см. в разделе Синхронизация параметров документации по VS Code.

Редактор github.dev полностью работает в песочнице браузера. Для выполнения большинства функций, которые вы будете использовать, этот редактор не клонирует репозиторий, а применяет расширение репозиториев GitHub. Ваша работа сохраняется в локальном хранилище браузера, пока вы не выполните фиксацию. Вам нужно регулярно фиксировать изменения, чтобы они были доступны в репозитории.

Чтобы использовать редактор github.dev, необходимо войти в github.dev в GitHub.com.

Открытие редактора github.dev

Любой репозиторий GitHub в github.dev можно открыть любым из следующих способов:

  • Чтобы открыть репозиторий на той же вкладке браузера, нажмите клавишу . при просмотре любого репозитория или запроса на вытягивание в GitHub.

    Чтобы открыть репозиторий на новой вкладке браузера, нажмите клавишу >.

  • В URL-адресе вместо "github.com" укажите "github.dev".

  • При просмотре файла используйте раскрывающееся меню рядом с и выберите github.dev.

    Снимок экрана: раскрывающееся меню для значка редактирования. Параметр "github.dev" выделен темно-оранжевым контуром.

Codespaces и github.dev

github.dev и GitHub Codespaces позволяют редактировать код непосредственно из репозитория. Но они предоставляют немного разные преимущества, в зависимости от варианта использования.

github.devGitHub Codespaces
СтоимостьСвободная.Бесплатная ежемесячная квота использования для личных учетных записей. Сведения о ценах см. в разделе Сведения о выставлении счетов для GitHub Codespaces.
ДоступностьДоступно для всех пользователей на сайте GitHub.com.Доступно для всех пользователей на сайте GitHub.com.
Запускgithub.dev открывается мгновенно при нажатии клавиши, и вы можете начать использовать его сразу, не дожидаясь дополнительной настройки или установки.При создании или возобновлении пространства кода потребуются настройка виртуальной машины и контейнера на основе содержимого файла devcontainer.json. Для этого нужно настроить среду, что занимает несколько минут. Дополнительные сведения см. в разделе Создание codespace для репозитория.
Среда выполнения приложенийВычислительные ресурсы не предоставляются, поэтому вы не сможете компилировать и запускать код или использовать интегрированный терминал.С помощью GitHub Codespaces вы получаете возможности выделенной виртуальной машины, на которой можно запускать и отлаживать приложение.
Доступ к терминалуНет.GitHub Codespaces предоставляет общий набор средств по умолчанию, что означает, что терминал можно использовать точно так же, как и в локальной среде.
РасширенияВ представлении расширений появится только подмножество расширений, которые могут выполняться в формате веб-приложения. Дополнительные сведения см. в разделе Использование расширений.С помощью GitHub Codespaces можно использовать большинство расширений из Visual Studio Code Marketplace.

Продолжить работу с Codespaces

Вы можете запустить рабочий процесс в github.dev и продолжить работу с codespace. Если вы попытаетесь получить доступ к представлению запуска и отладки или терминалу, вы получите уведомление о том, что они недоступны в github.dev.

Чтобы продолжить работу в пространстве кода, последовательно щелкните Продолжить работу на... и Создать новое пространство кода, чтобы создать пространство кода для текущей ветви. Перед выполнением этого действия необходимо зафиксировать любые изменения.

Screenshot of the "Run and Debug" side bar with a message saying that this feature is not available, and a "Continue Working On" button.

Использование системы управления версиями

При использовании github.dev все действия управляются с помощью представления системы управления версиями, которое находится на панели действий слева. Дополнительные сведения о представлении системы управления версиями см. в разделе Управление версиями документации по VS Code.

Так как github.dev использует расширение GitHub Repositories для обеспечения своей функциональности, вы можете переключать ветви без необходимости прятать изменения. Дополнительные сведения см. в разделе Репозитории GitHub документации по VS Code.

Создание ветви

  1. Если текущая ветвь не отображается в строке состояния, в нижней части кодового пространства щелкните строку состояния правой кнопкой мыши и выберите Управление версиями.

  2. Выберите имя ветви в строке состояния.

    Снимок экрана: имя ветви, отображаемое в строке состояния VS Code.

  3. В раскрывающемся списке щелкните ветвь, на которую вы хотите переключиться, или введите имя новой ветви и щелкните Создать новую ветвь.

    Снимок экрана: раскрывающийся список для создания новой ветви в VS Code. Все незафиксированные изменения, внесенные в старой ветви, будут доступны и в новой ветви.

Фиксация изменений

  1. На панели действий щелкните представление Система управления версиями.

    Снимок экрана: панель действий VS Code с кнопкой управления версиями со значком ветви, выделенной оранжевым контуром.

  2. Чтобы подготовить изменения, щелкните рядом с измененным файлом или рядом с элементом Изменения , если вы изменили несколько файлов и хотите выполнить их все.

    Снимок экрана: боковая панель "Система управления версиями" с промежуточной кнопкой (знак "плюс") справа от "Изменения", выделенной темно-оранжевым контуром.

  3. В текстовом поле введите сообщение о фиксации, описывающее внесенные изменения.

    Снимок экрана: боковая панель "Система управления версиями" с сообщением о фиксации, введенным в текстовое поле над кнопкой "Фиксация".

  4. Щелкните Зафиксировать & Отправить.

    Изменения автоматически отправляются в ветвь на GitHub.

Создание запроса на включение изменений

  1. Зафиксировав изменения в локальной копии репозитория, щелкните значок запроса на вытягивание в верхней части боковой панели "Система управления версиями".

    Снимок экрана: верхняя часть боковой панели "Система управления версиями". Значок запроса на вытягивание выделен темно-оранжевым контуром.

  2. Убедитесь в том, что локальная ветвь и репозиторий, из которых выполняется слияние, а также удаленная ветвь и репозиторий, с которыми выполняется слияние, выбраны правильно. Затем задайте для запроса на вытягивание название и описание.

    Снимок экрана: боковая панель "GitHub Запрос на вытягивание" с формой для создания запроса на вытягивание, включая поля "Название" и "Описание".

  3. Нажмите кнопку Create (Создать).

Работа с существующим запросом на вытягивание

Для работы с существующим запросом на вытягивание можно использовать github.dev.

  1. Перейдите к запросу на вытягивание, который вы хотите открыть в github.dev.
  2. Нажмите, . чтобы открыть запрос на вытягивание в github.dev.
  3. Внесите нужные изменения и зафиксируйте их, выполнив действия, описанные в разделе Фиксация изменений. Все изменения будут сразу зафиксированы в выбранной ветви, их не нужно дополнительно отправлять.

Применение расширений

Редактор github.dev поддерживает расширения VS Code, которые были специально созданы или обновлены для запуска в Интернете. Такие расширения называются "веб-расширениями". Сведения о том, как создать веб-расширение или дополнить существующее расширение поддержкой этого формата, см. в разделе Веб-расширения документации по VS Code.

Расширения, которые могут выполняться в github.dev, будут отображаться в представлении расширений и могут быть установлены. При использовании синхронизации параметров автоматически устанавливаются и все совместимые расширения. Подробнее см. раздел Синхронизация параметров документации по VS Code.

Использование github.dev за брандмауэром

Если вы работаете за брандмауэром, необходимо добавить следующие URL-адреса в список разрешений брандмауэра:

URL-адресИспользование
https://*.vscode-cdn.netgithub.dev полностью выполняется в браузере. Для этого необходимо скачать ресурсы VS Code из конечных точек по этому URL-адресу.
https://update.code.visualstudio.comКак описано выше.
https://api.github.comИспользуется для получения исходных файлов из GitHub
https://vscode-sync-insiders.trafficmanager.netДополнительные. Чтобы разрешить синхронизацию параметров с помощью синхронизации параметров.

Каждое расширение, установленное в github.dev, выполняется в независимой веб-рабочей роли. Это добавляет уровень безопасности между несколькими расширениями, работающими в одном браузере. В результате URL-адреса запросов, поступающие от расширений, похожи на следующие: https://v--151hfiju3s93ktt2rqh65902gukb27osot905m4g52k40kaea3h6.vscode-cdn.net.

Данные извлекаются из репозитория во время выполнения с помощью расширения GitHub Repositories . Эти данные не хранятся на локальном компьютере между сеансами github.dev, за исключением хранилища несохраненных файлов в браузере и отображаемых в настоящее время файлов (для обеспечения перезагрузки страниц). Единственные данные, не относящиеся к репозиторию, которые хранятся локально между сеансами, — это некоторые параметры пользователя и учетные данные, отправленные потоком проверки подлинности GitHub.

Устранение неполадок

Если у вас возникли проблемы при открытии github.dev, попробуйте выполнить следующие действия:

  • Убедитесь, что вы выполнили вход в GitHub.
  • Отключите все блокировщики рекламы.
  • Используйте окно без инкогнито в браузере, чтобы открыть github.dev.

Известные ограничения

  • Редактор github.dev в настоящее время поддерживается в Chrome (и других браузерах на основе Chromium), Edge, Firefox и Safari. Мы рекомендуем всегда использовать последнюю версию любого из этих браузеров.
  • Некоторые настраиваемые сочетания клавиш могут работать не во всех браузерах. Существующие ограничения для настраиваемых сочетаний клавиш описаны в разделе Известные ограничения и адаптации документации по VS Code.
  • . Может не работать при открытии github.dev в соответствии с локальной раскладкой клавиатуры. В этом случае можно открыть любой репозиторий GitHub в github.dev, изменив URL-адрес с github.com на github.dev.