# Устранение неполадок с клиентами GitHub Codespaces
В этой статье содержатся сведения об устранении неполадок, которые могут возникнуть у клиента, используемого для GitHub Codespaces.
## Устранение неполадок веб-клиента Visual Studio Code
Если возникают проблемы с использованием GitHub Codespaces в браузере, не основанном на Chromium, попробуйте перейти на браузер на Chromium, например Google Chrome или Microsoft Edge. Кроме того, проверьте наличие известных проблем с браузером в [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen) репозитории, выполнив поиск проблем, помеченных именем браузера, например[`firefox`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+label%3Afirefox) или.[`safari`](https://github.com/Microsoft/vscode/issues?q=is%3Aopen+is%3Aissue+label%3Asafari)
При возникновении проблем с использованием GitHub Codespaces в браузере на основе Chromium можно проверить, возникает ли другая известная проблема с VS Code в репозитории [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen) .
### Различия от работы в VS Code локально
При открытии пространства кода в браузере с помощью веб-клиента VS Code вы заметите некоторые отличия от работы в локальной рабочей области в классическом приложении VS Code. Например, некоторое настраиваемое сочетание клавиш будет отличаться или отсутствовать, а некоторые расширения могут вести себя по-разному. Сводка см. [в статье "Известные ограничения и адаптации](https://code.visualstudio.com/docs/remote/codespaces#_known-limitations-and-adaptations) " в документации VS Code .
Вы можете проверить наличие известных проблем и записать новые проблемы с интерфейсом VS Code в репозитории [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+codespaces) .
### Visual Studio Code Инсайдеры
Visual Studio Code Участники программы предварительной оценки — это наиболее частый выпуск VS Code. Он содержит все последние функции и исправления ошибок, но иногда может содержать новые проблемы, которые приводят к неисправной сборке.
Если вы используете сборку программы предварительной оценки и заметили реакцию на проблемы в работе, рекомендуется переключиться на Visual Studio Code (стабильная версия) и повторить попытку.
Щелкните (Управление) в левом нижнем углу редактора и выберите **"Перейти к стабильной версии...**". Если веб-клиент VS Code не загружается или недоступен, вы можете принудительно переключиться на Visual Studio Code Стабильный, добавив `?vscodeChannel=stable` в URL-адрес пространства кода и загрузив пространство кода по указанному URL-адресу.
Если проблема не устранена в Visual Studio Code Стабильный, проверьте наличие известных проблем и при необходимости войдите в журнал новой проблемы с интерфейсом VS Code в репозитории [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+codespaces) .
### Устранение неполадок с простым браузером
При запуске веб-приложения в пространстве кода можно просмотреть запущенное приложение в простом браузере, внедренном в VS Code. В некоторых проектах приложение автоматически открывается на вкладке "Простой браузер" в редакторе при запуске приложения. Это происходит, если в `devcontainer.json` файле конфигурации для пространства кода задается `openPreview`свойство порта, `onAutoForward` на котором выполняется приложение.
```json
"portsAttributes": {
"3000": {
"label": "Application",
"onAutoForward": "openPreview"
}
}
```
Если вкладка "Простой браузер" не открывается автоматически, вы можете открыть простой браузер вручную для просмотра приложения.
1. В VS Codeщелкните вкладку **"Порты** ".
2. Щелкните правой кнопкой мыши порт, а затем щелкните **"Предварительный просмотр" в редакторе**.
#### Простая вкладка браузера не открывается автоматически
`devcontainer.json` Если файл конфигурации указывает `"onAutoForward": "openPreview"` порт, но простой браузер не открывается автоматически при запуске приложения, убедитесь, что приложение запущено на порту, указанном в конфигурации. Приложение может начинаться с другого порта, если предполагаемый порт занят.
Для реализации конфигурации порта, указанной в `devcontainer.json`файле GitHub Codespaces записывает конфигурацию в файл VS Code `settings.json` при создании пространства кода. Вы можете проверить правильность `settings.json` записи конфигурации в пространство кода.
1. В терминале в пространстве кода введите следующую команду.
```bash copy
cat ~/.vscode-remote/data/Machine/settings.json
```
2. Убедитесь, что `settings.json` файл содержит строки, как показано ниже.
```json
"remote.portsAttributes": {
"3000": {
"label": "Application",
"onAutoForward": "openPreview"
}
}
```
`settings.json` Если файл не содержит этих параметров, проверьте, включена ли функция dotfile и какая-либо конфигурация в dotfiles перезаписывает `settings.json` файл. Дополнительные сведения см. в разделе [Персонализация GitHub Codespaces для вашего аккаунта](/ru/codespaces/setting-your-user-preferences/personalizing-github-codespaces-for-your-account#dotfiles).
#### Приложение не загружается
Иногда можно обнаружить, что откроется вкладка "Простой браузер", но отображается значок страницы ошибки или пустая страница вместо запущенного приложения. Это может произойти, если загружаемое веб-приложение включает политику безопасности содержимого (CSP), которая ограничивает домены, в которых могут быть внедрены страницы сайта. Дополнительные сведения см. в разделе [CSP: frame-предки](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/frame-ancestors) на веб-сайте mdn.
Вы можете изменить политику безопасности приложения `frame-ancestors` локально, чтобы приложение отображалось в простом браузере. Кроме того, если `frame-ancestors` политика вызывает проблему, вы сможете просмотреть приложение, открыв его на обычной вкладке браузера, а не в простом браузере. Для этого щелкните вкладку **"Порты** " в VS Code, щелкните порт правой кнопкой мыши и нажмите кнопку **"Открыть в браузере**".
## Устранение неполадок с данными VS Code
При открытии пространства кода в классическом приложении VS Code вы можете заметить несколько различий по сравнению с работой в локальной рабочей области, но интерфейс должен быть аналогичным.
При возникновении проблем можно проверить наличие известных проблем и записать новые проблемы с интерфейсом VS Code в репозитории [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+codespaces) .
### Visual Studio Code Инсайдеры
Visual Studio Code Участники программы предварительной оценки — это наиболее частый выпуск VS Code. Он содержит все последние функции и исправления ошибок, но иногда может содержать новые проблемы, которые приводят к неисправной сборке.
Если вы используете сборку программы предварительной оценки и заметили реакцию на проблемы в работе, рекомендуется переключиться на Visual Studio Code (стабильная версия) и повторить попытку.
Чтобы переключиться на Visual Studio Code Стабильный, закройте приложение Visual Studio Code Программы предварительной оценки, откройте приложение Visual Studio Code Стабильное приложение и повторно откройте пространство кода.
Если проблема не устранена в Visual Studio Code Стабильный, проверьте наличие известных проблем и при необходимости войдите в журнал новой проблемы с интерфейсом VS Code в репозитории [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+codespaces) .
### Устранение неполадок с простым браузером
При запуске веб-приложения в пространстве кода можно просмотреть запущенное приложение в простом браузере, внедренном в VS Code. В некоторых проектах приложение автоматически открывается на вкладке "Простой браузер" в редакторе при запуске приложения. Это происходит, если в `devcontainer.json` файле конфигурации для пространства кода задается `openPreview`свойство порта, `onAutoForward` на котором выполняется приложение.
```json
"portsAttributes": {
"3000": {
"label": "Application",
"onAutoForward": "openPreview"
}
}
```
Если вкладка "Простой браузер" не открывается автоматически, вы можете открыть простой браузер вручную для просмотра приложения.
1. В VS Codeщелкните вкладку **"Порты** ".
2. Щелкните правой кнопкой мыши порт, а затем щелкните **"Предварительный просмотр" в редакторе**.
#### Простая вкладка браузера не открывается автоматически
`devcontainer.json` Если файл конфигурации указывает `"onAutoForward": "openPreview"` порт, но простой браузер не открывается автоматически при запуске приложения, убедитесь, что приложение запущено на порту, указанном в конфигурации. Приложение может начинаться с другого порта, если предполагаемый порт занят.
Для реализации конфигурации порта, указанной в `devcontainer.json`файле GitHub Codespaces записывает конфигурацию в файл VS Code `settings.json` при создании пространства кода. Вы можете проверить правильность `settings.json` записи конфигурации в пространство кода.
1. В терминале в пространстве кода введите следующую команду.
```bash copy
cat ~/.vscode-remote/data/Machine/settings.json
```
2. Убедитесь, что `settings.json` файл содержит строки, как показано ниже.
```json
"remote.portsAttributes": {
"3000": {
"label": "Application",
"onAutoForward": "openPreview"
}
}
```
`settings.json` Если файл не содержит этих параметров, проверьте, включена ли функция dotfile и какая-либо конфигурация в dotfiles перезаписывает `settings.json` файл. Дополнительные сведения см. в разделе [Персонализация GitHub Codespaces для вашего аккаунта](/ru/codespaces/setting-your-user-preferences/personalizing-github-codespaces-for-your-account#dotfiles).
#### Приложение не загружается
Иногда можно обнаружить, что откроется вкладка "Простой браузер", но отображается значок страницы ошибки или пустая страница вместо запущенного приложения. Это может произойти, если загружаемое веб-приложение включает политику безопасности содержимого (CSP), которая ограничивает домены, в которых могут быть внедрены страницы сайта. Дополнительные сведения см. в разделе [CSP: frame-предки](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/frame-ancestors) на веб-сайте mdn.
Вы можете изменить политику безопасности приложения `frame-ancestors` локально, чтобы приложение отображалось в простом браузере. Кроме того, если `frame-ancestors` политика вызывает проблему, вы сможете просмотреть приложение, открыв его на обычной вкладке браузера, а не в простом браузере. Для этого щелкните вкладку **"Порты** " в VS Code, щелкните порт правой кнопкой мыши и нажмите кнопку **"Открыть в браузере**".