Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

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 Enterprise Cloud 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.

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

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

Por padrão, quando você desabilitar a Sincronização de Configurações, 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 os codespaces ainda estiverem sendo criados com as configurações armazenadas em cache e você quiser voltar a usar as configurações padrão do VS Code neles, poderá limpar o cache na nuvem ao desabilitar a Sincronização de Configurações.

  1. Se a Sincronização de Configurações estiver desabilitada na sua instância do VS Code, primeiro será necessário habilitá-la. 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.