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

Устранение неполадок веб-клиента Visual Studio Code

При возникновении проблем с использованием GitHub Codespaces в браузере, который не Chromium, попробуйте переключиться на браузер на основе Chromium, например Google Chrome или Microsoft Edge. Кроме того, проверка известные проблемы с браузером в microsoft/vscode репозитории путем поиска проблем с именем браузера, например firefox или safari.

При возникновении проблем с использованием GitHub Codespaces в браузере на основе Chromium вы можете проверка, если у вас возникла другая известная проблема с VS Code в репозиторииmicrosoft/vscode.

Отличия от локальной работы в VS Code

При открытии codespace в браузере с помощью веб-клиента VS Code вы заметите некоторые отличия от работы в локальной рабочей области в классическом приложении VS Code. Например, некоторое настраиваемое сочетание клавиш будет отличаться или отсутствовать, а некоторые расширения могут вести себя по-разному. Сводку см. в разделе "Известные ограничения и адаптации" в документации по VS Code.

Вы можете проверка известные проблемы и регистрируют новые проблемы в интерфейсе VS Code в репозиторииmicrosoft/vscode.

Visual Studio Code Insiders

Visual Studio Code Участники программы предварительной оценки — это наиболее частый выпуск VS Code. Он содержит все последние функции и исправления ошибок, но иногда может содержать новые проблемы, которые приводят к неисправной сборке.

Если вы используете сборку программы предварительной оценки и заметили реакцию на проблемы в работе, рекомендуется переключиться на Visual Studio Code (стабильная версия) и повторить попытку.

Щелкните в левом нижнем углу редактора и выберите Переключиться на стабильную версию.... Если веб-клиент VS Code не загружается или недоступен, можно принудительно переключиться на Visual Studio Code Stable, добавив ?vscodeChannel=stable к URL-адресу codespace и загрузив codespace по нему.

Если проблема не устранена в Visual Studio Code Стабильный, проверка известные проблемы и при необходимости зафиксировать новую проблему в интерфейсе VS Code в репозиторииmicrosoft/vscode.

Устранение неполадок в простом браузере

После запуска веб-приложения в codespace можно просмотреть запущенное приложение в простом браузере, внедренном в VS Code. В некоторых проектах приложение автоматически открывается на вкладке Простой браузер в редакторе при запуске приложения. Это происходит, если в devcontainer.json файле конфигурации для codespace свойство порта, на котором выполняется приложение, onAutoForward имеет значение openPreview.

"portsAttributes": {
  "3000": {
    "label": "Application",
    "onAutoForward": "openPreview"
  }
}

Если вкладка Простой браузер не открывается автоматически, вы можете открыть простой браузер вручную, чтобы просмотреть приложение.

1. В VS Code откройте вкладку Порты .

2. Щелкните правой кнопкой мыши порт и выберите в редакторе команду Предварительный просмотр.

   

Вкладка простого браузера не открывается автоматически

Если в devcontainer.json файле конфигурации указано "onAutoForward": "openPreview" значение для порта, но простой браузер не открывается автоматически при запуске приложения, убедитесь, что приложение запущено через порт, указанный в конфигурации. Приложение может запускаться на другом порту, если он занят.

Для реализации конфигурации порта, указанной в devcontainer.json, GitHub Codespaces записывает конфигурацию в файл VS Code settings.json при создании codespace. Вы можете проверить правильность записи settings.json конфигурации в codespace.

1. В окне терминала в codespace введите следующую команду.

   Shell

   cat ~/.vscode-remote/data/Machine/settings.json

2. Убедитесь, что settings.json файл содержит строки, подобные приведенным ниже.

    "remote.portsAttributes": {
        "3000": {
            "label": "Application",
            "onAutoForward": "openPreview"
        }
    }
   

settings.json Если файл не содержит эти параметры, проверьте, включены ли файлы точек и перезаписывает settings.json ли файл какая-либо конфигурация в файлах точек. Дополнительные сведения см. в разделе Персонализация GitHub Codespaces для вашей учетной записи.

Приложение не загружается

Иногда открывается вкладка Простой браузер, но вместо запущенного приложения отображается значок страницы ошибки или пустая страница. Это может произойти, если загружаемое веб-приложение содержит политику безопасности содержимого (CSP), которая ограничивает домены, в которые могут быть внедрены страницы сайта. Дополнительные сведения см. в разделе CSP: frame-ancestors на веб-сайте mdn.

Вы можете изменить политику безопасности приложения frame-ancestors локально, чтобы приложение отображалось в простом браузере. Кроме того, если проблема вызвана политикой frame-ancestors , вы сможете просмотреть приложение, открыв его в обычной вкладке браузера, а не в простом браузере. Для этого откройте вкладку Порты в VS Code, щелкните порт правой кнопкой мыши и выберите команду Открыть в браузере.