---
id: "arquivos-arvore-e-status"
titulo: "A árvore e o status do git"
resumo: "Navegar na árvore do workspace, mostrar dotfiles e arquivos ignorados e ler as marcações de status do git em cada linha."
idioma: "pt-br"
tipo: "guia"
categoria: "arquivos-git"
aplicavelDesde: "0.0.16"
capabilities: ["fileTree.panel.browse", "fileTree.toggles.dotfiles.gitignored", "fileTree.status.gitDecorations"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/pt-br/ferramentas/arquivos/arvore-e-status/"
fonte: "pt-br/ferramentas/arquivos/arvore-e-status.md"
caminhoPublico: "docs/publica/pt-br/ferramentas/arquivos/arvore-e-status.md"
hashFonte: "sha256:5ffa4d00abee538a93e09447b2847bd2c511db0140ec7132a9ddcb5d16829f7e"
hashDestaPagina: "sha256:5ffa4d00abee538a93e09447b2847bd2c511db0140ec7132a9ddcb5d16829f7e"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
## Navegar na árvore

- O painel Arquivos é aberto pelo Inspetor e mostra a árvore do **workspace selecionado**.
- Cada pasta expande individualmente e carrega sob demanda.
- A árvore é **virtualizada**: mesmo com muitos arquivos, ela desenha o que está à vista.
- A barra de ações tem **recolher tudo** e **reler os arquivos** — reler é o que você usa quando algo mudou no disco fora do app.

### Estados que você pode encontrar

| Estado | O que significa |
|---|---|
| **Carregando** | A pasta está sendo lida |
| **Vazia** | A pasta existe e não tem conteúdo visível |
| **Erro** | A leitura falhou — aparece mensagem de acesso negado, em vez de lista vazia |

Erro de leitura **não** é o mesmo que pasta vazia: se você vir acesso negado, o problema é permissão ou conexão, não ausência de arquivos.

## Mostrar dotfiles e arquivos ignorados

Duas opções independentes na barra de ações:

- **Mostrar dotfiles** — inclui arquivos e pastas que começam com ponto.
- **Mostrar os ignorados pelo git** — inclui o que o `.gitignore` esconde.

As duas são **por worktree**: ligar numa não liga na outra.

> O interruptor dos ignorados só aparece quando faz sentido para aquele workspace. Não encontrá-lo não é defeito.

## Marcações de status do git

As linhas da árvore mostram o **status de cada arquivo** em relação ao git do worktree ativo — modificado, adicionado, apagado e os demais estados conhecidos.

- O status vem do **git do projeto**, não do painel: é a mesma informação que a área de git mostra.
- As marcações são uma leitura, não um comando: clicar na linha abre o arquivo, não prepara nem descarta a alteração.
- Se as marcações parecerem desatualizadas, **releia os arquivos** pela barra de ações.

## Onde isso é diferente do que você espera

- **A árvore não é a pasta do projeto inteira quando o workspace aponta para uma subpasta.** Ela mostra a pasta do workspace selecionado.
- **A árvore não esconde nada por conta própria** além do que as duas opções controlam: se um arquivo não aparece, confira se ele é um dotfile ou está no `.gitignore`.

## Relacionados

- [Buscar arquivos e conteúdo](/docs/pt-br/ferramentas/arquivos/buscar/)
- [Abrir e visualizar arquivos](/docs/pt-br/ferramentas/arquivos/abrir-e-visualizar/)