Примечание. Использование GitHub Codespaces с URI JetBrains в настоящее время находится в общедоступной бета-версии и может быть изменено.
Устранение неполадок веб-клиента 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"
}
}
Если вкладка Простой браузер не открывается автоматически, вы можете открыть простой браузер вручную, чтобы просмотреть приложение.
-
В VS Code откройте вкладку Порты .
-
Щелкните правой кнопкой мыши порт и выберите в редакторе команду Предварительный просмотр.
Вкладка простого браузера не открывается автоматически
Если в devcontainer.json
файле конфигурации указано "onAutoForward": "openPreview"
значение для порта, но простой браузер не открывается автоматически при запуске приложения, убедитесь, что приложение запущено через порт, указанный в конфигурации. Приложение может запускаться на другом порту, если он занят.
Для реализации конфигурации порта, указанной в devcontainer.json
, GitHub Codespaces записывает конфигурацию в файл VS Code settings.json
при создании codespace. Вы можете проверить правильность записи settings.json
конфигурации в codespace.
-
В окне терминала в codespace введите следующую команду.
Shell cat ~/.vscode-remote/data/Machine/settings.json
-
Убедитесь, что
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, щелкните порт правой кнопкой мыши и выберите команду Открыть в браузере.
Устранение неполадок с VS Code
При открытии codespace в классическом приложении VS Code вы можете заметить несколько различий по сравнению с работой в локальной рабочей области, но взаимодействие должно быть аналогичным.
При возникновении проблем можно проверка известных проблем и регистрируют новые проблемы в интерфейсе VS Code в репозиторииmicrosoft/vscode
.
Visual Studio Code Insiders
Visual Studio Code Участники программы предварительной оценки — это наиболее частый выпуск VS Code. Он содержит все последние функции и исправления ошибок, но иногда может содержать новые проблемы, которые приводят к неисправной сборке.
Если вы используете сборку программы предварительной оценки и заметили реакцию на проблемы в работе, рекомендуется переключиться на Visual Studio Code (стабильная версия) и повторить попытку.
Чтобы переключиться на Visual Studio Code Stable, закройте приложение Visual Studio Code, откройте приложение Visual Studio Code Stable и снова откройте codespace.
Если проблема не устранена в Visual Studio Code Стабильный, проверка известные проблемы и при необходимости зафиксировать новую проблему в интерфейсе VS Code в репозиторииmicrosoft/vscode
.
Устранение неполадок в простом браузере
После запуска веб-приложения в codespace можно просмотреть запущенное приложение в простом браузере, внедренном в VS Code. В некоторых проектах приложение автоматически открывается на вкладке Простой браузер в редакторе при запуске приложения. Это происходит, если в devcontainer.json
файле конфигурации для codespace свойство порта, на котором выполняется приложение, onAutoForward
имеет значение openPreview
.
"portsAttributes": {
"3000": {
"label": "Application",
"onAutoForward": "openPreview"
}
}
Если вкладка Простой браузер не открывается автоматически, вы можете открыть простой браузер вручную, чтобы просмотреть приложение.
-
В VS Code откройте вкладку Порты .
-
Щелкните правой кнопкой мыши порт и выберите в редакторе команду Предварительный просмотр.
Вкладка простого браузера не открывается автоматически
Если в devcontainer.json
файле конфигурации указано "onAutoForward": "openPreview"
значение для порта, но простой браузер не открывается автоматически при запуске приложения, убедитесь, что приложение запущено через порт, указанный в конфигурации. Приложение может запускаться на другом порту, если он занят.
Для реализации конфигурации порта, указанной в devcontainer.json
, GitHub Codespaces записывает конфигурацию в файл VS Code settings.json
при создании codespace. Вы можете проверить правильность записи settings.json
конфигурации в codespace.
-
В окне терминала в codespace введите следующую команду.
Shell cat ~/.vscode-remote/data/Machine/settings.json
-
Убедитесь, что
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, щелкните порт правой кнопкой мыши и выберите команду Открыть в браузере.
Устранение неполадок с ИНДЕ JetBrains
Проблемы с производительностью
Тип компьютера GitHub Codespaces с по крайней мере 4 ядрами рекомендуется использовать для выполнения любого из ИНДЕ JetBrains. Дополнительные сведения см. в разделе Изменение типа компьютера для codespace.
Если вы используете компьютер с 4 или более ядрами и производительность JetBrains кажется немного вялой, может потребоваться увеличить максимальный размер кучи Java.
Рекомендуемый размер кучи зависит от типа компьютера codespace.
Тип компьютера | Максимальный размер кучи |
---|---|
4 ядра, 8 ГБ ОЗУ | 2048 МиБ |
8 ядер, 16 ГБ ОЗУ | 4096 МиБ |
16 ядер, 32 ГБ ОЗУ | 8192 МиБ |
32 ядра, 64 ГБ ОЗУ | 16 384 МиБ |
Если размер кучи меньше рекомендуемого значения, при запуске codespace отображается сообщение с предложением увеличить размер кучи. Чтобы автоматически увеличить размер кучи, щелкните ссылку в сообщении.
В зависимости от размера базы кода и объема памяти, необходимой для запуска приложения, может потребоваться дополнительно увеличить размер кучи. Необходимо задать размер кучи в диапазоне от размера, показанного в таблице выше, до 60 % ОЗУ удаленного узла. При наличии большого приложения не следует задавать слишком большой размер кучи, чтобы предоставить приложению достаточный объем памяти.
-
В левой части панели навигации в верхней части окна приложения щелкните имя codespace.
-
На вкладке Производительность обратите внимание на сведения о загрузке ЦП и памяти. Они указывают, перегружен ли компьютер.
-
Перейдите на вкладку Параметры и измените размер кучи, увеличив его до не более 60 % доступной памяти для codespace.
-
Нажмите кнопку Сохранить и перезапустить.
Невозможно открыть клиент в MacOS Ventura
В MacOS Ventura при использовании версий шлюза JetBrains, предшествующих версии 2022.3, при первой попытке подключиться к codespace из шлюза JetBrains отображается сообщение о том, что клиентское приложение JetBrains "повреждено и не может быть открыто".

Эта проблема устранена в шлюзе JetBrains версии 2022.3 и более поздних версий.
Чтобы избежать этой проблемы, обновите шлюз JetBrains.
Чтобы обойти эту проблему в более старых версиях шлюза, выполните следующие действия.
-
Нажмите кнопку Отмена , чтобы закрыть это сообщение.
-
Щелкните значок Apple в левом верхнем углу экрана и щелкните Параметры системы.
-
Щелкните Конфиденциальность & Безопасность и прокрутите вниз до раздела "Безопасность".
Вы увидите сообщение о том, что клиент JetBrains заблокирован.
-
Нажмите кнопку Открыть в любом случае , чтобы добавить клиент JetBrains в распознанные приложения. Сообщение отобразится снова, но на этот раз с кнопкой Открыть .
-
Нажмите кнопку Отмена еще раз.
-
Назад к приложению шлюза JetBrains и снова подключитесь к требуемому пространству кода. Клиент JetBrains откроется успешно. Авторизовать клиентское приложение для запуска на компьютере Mac вы не увидите сообщение при подключении к codespace в будущем.
Проблемы с SSH-подключением
Для подключения через сервер SSH, работающий в codespace, необходимо иметь ключ SSH в каталоге ~/.ssh
(MacOS и Linux) или %HOMEPATH%\.ssh
каталоге (Windows), который уже добавлен в учетную запись GitHub. Если в этом каталоге нет ключей, GitHub CLI создаст ключи. Дополнительные сведения см. в разделе Добавление нового ключа SSH в учетную запись GitHub.
При возникновении проблем с проверкой ключа попробуйте обновить версию GitHub CLI. Дополнительные сведения см. в инструкциях по обновлению в файле сведений для GitHub CLI.
Проблемы с интегрированной среды разработки JetBrains
Справку по проблемам, связанным с используемой интегрированной среды разработки JetBrains или приложением шлюза JetBrains, см. в разделе Поддержка продуктов на веб-сайте JetBrains.