Pular para o conteúdo principal

Solução de Problemas na Leitura de Base de Código

info

Se o Cursor estiver tendo problemas para ler sua base de código ou arquivos, siga este guia para resolver problemas comuns.

Sintomas Comuns​

  1. Cursor não consegue ver os arquivos do projeto
  2. Recursos de IA não funcionam com a base de código
  3. Árvore de arquivos não atualiza
  4. Funcionalidade de busca não funciona

Soluções Rápidas​

1. Atualizar a Árvore de Arquivos​

A solução mais rápida geralmente é atualizar sua árvore de arquivos:

  1. Clique com o botão direito no explorador de arquivos
  2. Selecione "Atualizar"
  3. Aguarde a atualização da árvore de arquivos

2. Verificar Permissões de Arquivos​

  1. Clique com o botão direito na pasta do seu projeto
  2. Selecione "Propriedades"
  3. Vá para a aba "Segurança"
  4. Certifique-se de que seu usuário tem permissões de "Leitura" e "Escrita"

3. Verificar .gitignore e .cursorignore​

Às vezes, arquivos são intencionalmente ignorados. Verifique:

  1. Conteúdo do arquivo .gitignore
  2. Conteúdo do arquivo .cursorignore
  3. Remova padrões que não deveriam ser ignorados

Soluções Aprofundadas​

Problemas com o Observador do Sistema de Arquivos​

Se o Cursor não estiver detectando alterações de arquivos:

.vscode/settings.json
{
  "files.watcherExclude": {
    "**/node_modules/**": true,
    "**/dist/**": true,
    // Adicione outros diretórios que você deseja excluir
  }
}

Lidando com Grandes Bases de Código​

Para grandes bases de código:

  1. Aumentar Limite de Memória

    .cursor/settings.json
    {
      "files.maxMemoryForLargeFilesMB": 4096
    }

  2. Otimizar Observação de Arquivos

    • Excluir diretórios desnecessários
    • Usar recursos de confiança do workspace
    • Considerar usar armazenamento do workspace

Problemas de Integração com Git​

Se recursos relacionados ao Git não estiverem funcionando:

  1. Verificar instalação do Git:

    git --version

  2. Verificar configuração do Git:

    git config --list

  3. Redefinir cache do Git:

    git rm -r --cached .
    git add .

Dicas de Prevenção​

  1. Estrutura Limpa de Projeto

    • Organizar arquivos logicamente
    • Usar .gitignore apropriado
    • Manter diretório raiz limpo

  2. Manutenção Regular

    • Limpar cache do editor regularmente
    • Atualizar o Cursor frequentemente
    • Monitorar recursos do sistema

  3. Otimização de Desempenho

    • Excluir arquivos binários grandes
    • Usar armazenamento do workspace
    • Implementar padrões de ignorar adequados

Solução de Problemas Avançada​

Registro e Diagnóstico​

Habilitar registro detalhado:

  1. Abra a Paleta de Comandos (Ctrl/Cmd + Shift + P)
  2. Digite "Developer: Set Log Level"
  3. Selecione "Trace"

Redefinição de Cache​

Se os problemas persistirem:

  1. Feche o Cursor
  2. Exclua diretórios de cache:
    • Windows: %APPDATA%\Cursor\Cache
    • macOS: ~/Library/Application Support/Cursor/Cache
    • Linux: ~/.config/Cursor/Cache
  3. Reinicie o Cursor

Confiança do Workspace​

Configure a confiança do workspace:

  1. Abra a Paleta de Comandos
  2. Pesquise por "Workspace Trust"
  3. Configure as configurações de confiança para seu projeto

Quando Contatar o Suporte​

Contate o suporte do Cursor se:

  1. Problemas persistirem após tentar todas as soluções
  2. Você encontrar perda de dados
  3. O desempenho degradar significativamente
  4. Você encontrar preocupações de segurança
dica

Mantenha seus logs de erro e informações do sistema prontos ao contatar o suporte

Recursos Relacionados​