​
Visão Geral

O Cursor lê e indexa a base de código do seu projeto para alimentar suas funcionalidades. Controle quais diretórios e arquivos o Cursor pode acessar usando um arquivo .cursorignore no seu diretório raiz. O Cursor bloqueia o acesso a arquivos listados no .cursorignore de:
Chamadas de ferramentas iniciadas pelo Agent, como terminal e servidores MCP, não podem bloquear o acesso ao código governado pelo .cursorignore

​
Por que ignorar arquivos?

Segurança: Restrinja o acesso a chaves de API, credenciais e segredos. Embora o Cursor bloqueie arquivos ignorados, a proteção completa não é garantida devido à imprevisibilidade dos LLMs. Performance: Em bases de código grandes ou monorepos, exclua partes irrelevantes para indexação mais rápida e descoberta de arquivos mais precisa.

​
Arquivos de ignore globais

Defina padrões de ignore para todos os projetos nas configurações do usuário para excluir arquivos sensíveis sem configuração por projeto.
Lista Global de Ignore do Cursor
Os padrões padrão incluem:
  • Arquivos de ambiente: **/.env, **/.env.*
  • Credenciais: **/credentials.json, **/secrets.json
  • Chaves: **/*.key, **/*.pem, **/id_rsa

​
Configurando .cursorignore

Crie um arquivo .cursorignore no seu diretório raiz usando a sintaxe do .gitignore.

​
Exemplos de padrões

config.json      # Arquivo específico
dist/           # Diretório
*.log           # Extensão de arquivo
**/logs         # Diretórios aninhados
!app/           # Excluir da ignoração (negar)

​
Ignorar hierárquico

Habilite Cursor Settings > Features > Editor > Hierarchical Cursor Ignore para buscar arquivos .cursorignore em diretórios pai. Notas: Comentários começam com #. Padrões posteriores sobrescrevem os anteriores. Padrões são relativos à localização do arquivo.

​
Limitar indexação com .cursorindexingignore

Use .cursorindexingignore para excluir arquivos apenas da indexação. Esses arquivos permanecem acessíveis aos recursos de IA, mas não aparecerão nas pesquisas da base de código.

​
Arquivos ignorados por padrão

O Cursor ignora automaticamente arquivos em .gitignore e a lista de ignorados padrão abaixo. Substitua com o prefixo ! em .cursorignore.

​
Limitações de padrões de negação

Ao usar padrões de negação (prefixados com !), você não pode re-incluir um arquivo se um diretório pai for excluído via *. 
# Ignorar todos os arquivos na pasta public
public/*

# ✅ Isso funciona, pois o arquivo existe no nível superior
!public/index.html

# ❌ Isso não funciona - não é possível re-incluir arquivos de diretórios aninhados
!public/assets/style.css
Solução alternativa: Exclua explicitamente diretórios aninhados: 
public/assets/*
!public/assets/style.css # Este arquivo agora está acessível
Diretórios excluídos não são percorridos por questões de performance, então padrões em arquivos contidos não têm efeito. Isso corresponde à implementação do .gitignore para padrões de negação em diretórios aninhados. Para mais detalhes, consulte a documentação oficial do Git sobre padrões gitignore.

​
Solução de Problemas

Teste padrões com git check-ignore -v [file].