Visão geral
.cursorignore
no teu diretório raiz.
O Cursor bloqueia o acesso a arquivos listados em .cursorignore
em:
- Indexação do código
- Código acessível pelo Tab, Agent e Inline Edit
- Código acessível via referências com o símbolo @
Chamadas de ferramentas iniciadas pelo Agent, como o terminal e servidores MCP, não conseguem bloquear
o acesso ao código regido por
.cursorignore
Por que ignorar arquivos?
Arquivos de ignore globais

- Arquivos de ambiente:
**/.env
,**/.env.*
- Credenciais:
**/credentials.json
,**/secrets.json
- Chaves:
**/*.key
,**/*.pem
,**/id_rsa
Configurando .cursorignore
.cursorignore
no diretório raiz usando a sintaxe do .gitignore
.
Exemplos de padrões
Ignorar hierárquico
Cursor Settings
> Features
> Editor
> Hierarchical Cursor Ignore
para procurar .cursorignore
nos diretórios pai.
Notas: Comentários começam com #
. Padrões mais abaixo substituem os anteriores. Os padrões são relativos ao caminho do arquivo.
Limitar a indexação com .cursorindexingignore
.cursorindexingignore
para excluir arquivos apenas da indexação. Esses arquivos continuam acessíveis para os recursos de IA, mas não vão aparecer nas buscas na codebase.
Arquivos ignorados por padrão
.gitignore
e na lista padrão abaixo. Dá pra sobrescrever usando o prefixo !
em .cursorignore
.
Lista padrão de ignorados
Lista padrão de ignorados
Somente para indexação, estes arquivos são ignorados além dos do teu
.gitignore
, .cursorignore
e .cursorindexingignore
:Limitações dos padrões de negação
!
), não tem como reincluir um arquivo se um diretório pai foi excluído via *
.
Solução de problemas
git check-ignore -v [arquivo]
.