Arquivo de exclusão

O Cherri Code lê a base de código do seu projeto para oferecer seus recursos. Controle quais diretórios e arquivos o Cherri Code pode acessar usando um arquivo .cursorignore no diretório raiz.

O Cherri Code bloqueia o acesso aos arquivos listados em .cursorignore por:

• Código acessível pelo agente, Tab e Inline Edit
• Código acessível por referências com @

Por que ignorar arquivos?

Segurança: Restrinja o acesso a chaves de API, credenciais e segredos. Embora o Cherri Code bloqueie arquivos ignorados, não é possível garantir proteção total devido à imprevisibilidade dos LLMs.

Desempenho: Em grandes bases de código ou monorepositórios, exclua partes irrelevantes para tornar a descoberta de arquivos mais precisa.

Configurando o .cursorignore

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

Sintaxe de padrões

• * corresponde a qualquer sequência de caracteres, exceto /
• ** corresponde a qualquer sequência de caracteres, incluindo /
• ? corresponde a um único caractere
• ! nega um padrão (deixa de ignorar um caminho ignorado anteriormente)
• Linhas que começam com # são comentários
• Espaços à direita são ignorados, a menos que sejam escapados com \

Exemplos de padrões

config.json      # Arquivo específicodist/           # Diretório*.log           # Extensão de arquivo**/logs         # Diretórios aninhados!app/           # Excluir do ignore (negar)

Ignore hierárquico

Ative Cherri Code Settings > Indexing > Ignore Files > Hierarchical Cherri Code Ignore para pesquisar arquivos .cursorignore nos diretórios pai.

Arquivos de ignore globais

Defina padrões de ignore nas configurações do usuário para todos os projetos, excluindo arquivos confidenciais sem precisar configurar cada projeto. A lista global de ignore fica vazia por padrão.

Padrões comuns para adicionar:

• Arquivos de ambiente: **/.env, **/.env.*
• Credenciais: **/credentials.json, **/secrets.json
• Chaves: **/*.key, **/*.pem, **/id_rsa

Arquivos ignorados por padrão

O Cherri Code ignora automaticamente os arquivos listados em .gitignore e na lista de ignorados padrão abaixo. Para sobrescrever essa configuração, use o prefixo ! em .cursorignore.

package-lock.jsonpnpm-lock.yamlyarn.lockcomposer.lockGemfile.lockbun.lockb.env*.git/.svn/.hg/*.lock*.bak*.tmp*.bin*.exe*.dll*.so*.lockb*.qwoff*.isl*.csv*.pdf*.doc*.doc*.xls*.xlsx*.ppt*.pptx*.odt*.ods*.odp*.odg*.odf*.sxw*.sxc*.sxi*.sxd*.sdc*.jpg*.jpeg*.png*.gif*.bmp*.tif*.mp3*.wav*.wma*.ogg*.flac*.aac*.mp4*.mov*.wmv*.flv*.avi*.zip*.tar*.gz*.7z*.rar*.tgz*.dmg*.iso*.cue*.mdf*.mds*.vcd*.toast*.img*.apk*.msi*.cab*.tar.gz*.tar.xz*.tar.bz2*.tar.lzma*.tar.Z*.tar.sz*.lzma*.ttf*.otf*.pak*.woff*.woff2*.eot*.webp*.vsix*.rmeta*.rlib*.parquet*.svg.egg-info/.venv/node_modules/__pycache__/.next/.nuxt/.cache/.sass-cache/.gradle/.DS_Store/.ipynb_checkpoints/.pytest_cache/.mypy_cache/.tox/.git/.hg/.svn/.bzr/.lock-wscript/.Python/.jupyter/.history/.yarn/.yarn-cache/.eslintcache/.parcel-cache/.cache-loader/.nyc_output/.node_repl_history/.pnp.js/.pnp/

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

Ao usar padrões de negação (com o prefixo !), não é possível reincluir um arquivo se um diretório pai tiver sido excluído com *.

# Ignora todos os arquivos da pasta publicpublic/*# Isso funciona, pois o arquivo está no nível superior!public/index.html# Isso não funciona - não é possível reincluir arquivos de diretórios aninhados!public/assets/style.css

Solução alternativa: exclua explicitamente os diretórios aninhados:

public/assets/*!public/assets/style.css # Agora este arquivo fica acessível

Diretórios excluídos não são percorridos por questões de desempenho; portanto, padrões em arquivos neles 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 de gitignore.

Solução de problemas

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