Skip to main content

Opções de solução de problemas de personalização para o GitHub Codespaces

Etapas de solução de problemas comuns com dotfiles e Sincronização de Configurações.

Você pode personalizar o GitHub Codespaces usando um repositório dotfiles em GitHub ou usando Sincronização de Configurações. Para saber mais, confira Como personalizar o GitHub Codespaces para sua conta.

Solução de problemas de dotfiles

Se o seu codespace não consegue pegar as configurações de dotfiles, você deverá seguir as etapas de depuração a seguir.

  1. Habilite os dotfiles selecionando Instalar dotfiles automaticamente nas Configurações pessoais dos GitHub Codespaces.

    Captura de tela da seção "Dotfiles" das configurações do codespace, com a opção "Instalar dotfiles automaticamente" desmarcada.

  2. Verifique /workspaces/.codespaces/.persistedshare/dotfiles para ver se os dotfiles foram clonados.

    • Se seus dotfiles foram clonados, tente reexecutar manualmente seu script de instalação para verificar se é executável.
    • Se os dotfiles não foram clonados, verifique /workspaces/.codespaces/.persistedshare/EnvironmentLog.txt para ver se houve um problema ao cloná-los.
  3. Verifique /workspaces/.codespaces/.persistedshare/creation.log para ver se há possíveis problemas. Para obter mais informações, confira Logs de criação.

Se a configuração dos dotfiles for selecionada corretamente, mas parte da configuração for incompatível com os codespaces, use a variável de ambiente $CODESPACES para adicionar uma lógica condicional para configurações específicas do codespace. Para obter mais informações sobre configurações que podem ser incompatíveis com codespaces, confira:

Solução de Problemas da Sincronização de Configurações

Você pode desativar a Sincronização de Configurações a fim de interromper a sincronização de configurações de/para uma instância do VS Code.

Quando você desativa a Sincronização de Configurações em um codespace, novos codespaces continuarão a usar as configurações armazenadas em cache da última vez em que as suas configurações foram enviadas por push para a nuvem. Se você usar o cliente Web do VS Code para codespaces e quiser que os codespaces usem as configurações padrão em vez das configurações armazenadas em cache, desabilite a Sincronização de Configurações. Para obter mais informações, confira "Como gerenciar suas preferências para Sincronização de Configurações".

Se você quiser voltar a usar as configurações padrão do VS Code em todas as instâncias do VS Code, incluindo o aplicativo da área de trabalho, limpe o cache na nuvem ao desativar a Sincronização de Configurações.

  1. Se a Sincronização de Configurações estiver desativada na instância do VS Code e você quiser limpar as configurações armazenadas em cache, primeiro ative-a. Para obter instruções, confira a Como personalizar o GitHub Codespaces para sua conta.

  2. Na parte inferior da Barra de Atividades, selecione e clique em Ativar Sincronização de Configurações.

  3. Na lista suspensa, clique em Desativar Sincronização de Configurações.

    Captura de tela do menu suspenso com a opção "Sincronização de Configurações: Desativar" realçada com um contorno laranja escuro.

  4. Para limpar as configurações armazenadas em cache, no diálogo, selecione Desativar sincronização em todos os dispositivos e limpar os dados da nuvem.

    Captura de tela da caixa de diálogo "Deseja desativar a sincronização?" com a opção de limpar dados da nuvem selecionada.

  5. Clique em Desativar.