---
id: "arquivos-visao-geral"
titulo: "Arquivos, árvore e editor"
resumo: "Como o painel Arquivos, a árvore do workspace, o editor e os diffs se organizam dentro do projeto."
idioma: "pt-br"
tipo: "conceito"
categoria: "arquivos-git"
aplicavelDesde: "0.0.16"
capabilities: ["fileTree.panel.browse", "file.open"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/pt-br/ferramentas/arquivos/visao-geral/"
fonte: "pt-br/ferramentas/arquivos/visao-geral.md"
caminhoPublico: "docs/publica/pt-br/ferramentas/arquivos/visao-geral.md"
hashFonte: "sha256:afaeb55a39d781256b67cf30adc1f35adf9725e254be5c7d641792bd1918794d"
hashDestaPagina: "sha256:afaeb55a39d781256b67cf30adc1f35adf9725e254be5c7d641792bd1918794d"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
Trabalhar com arquivos no Elyra acontece em três lugares que se completam: o **painel Arquivos** (a árvore), o **editor** (o conteúdo) e o **diff** (o que mudou). Esta página dá o mapa; as páginas seguintes dão o passo a passo.

## A pasta do projeto e a pasta do workspace

Duas coisas parecidas que não são a mesma:

- **O git segue a pasta do projeto.**
- **Os arquivos seguem a pasta do workspace.**

Um workspace é um nome e uma pasta; vários workspaces podem apontar para a mesma pasta. O painel Arquivos mostra a árvore do **workspace selecionado**, e é isso que determina o que você vê quando abre um arquivo.

## O painel Arquivos

O painel Arquivos é a árvore do workspace:

- **Pastas e arquivos** em linhas, com expansão por pasta e estado de carregamento, vazio e erro.
- **Barra de ações** no topo, com recolher tudo, reler os arquivos, mostrar dotfiles, mostrar os ignorados pelo git e abrir em aplicativos externos.
- **Menu de contexto por linha**, com as ações do arquivo ou da pasta.
- **Menu de contexto no vazio**, para criar arquivo ou pasta na raiz.

A árvore é virtualizada: mesmo em repositórios grandes, ela desenha o que está à vista.

## O editor

Abrir um arquivo abre uma **aba de editor**. O que aparece dentro da aba depende do tipo do arquivo:

| Tipo | O que você vê |
|---|---|
| Texto e código | Editor de código, com abas, busca, substituição e salvar |
| Markdown | Fonte, edição rica ou pré-visualização, com sumário e exportação |
| Imagem, PDF, CSV, notebook, Mermaid | Visualizador próprio, em geral somente leitura |
| Diff | Comparação lado a lado ou em linha |

O mesmo editor aparece em dois lugares: como **aba** e como **painel lateral** do Inspetor.

## Diffs

Um diff compara o que está no disco com o que está no git — o arquivo antes e depois da sua alteração. Existem três formas de olhar para isso:

- **Diff de um arquivo** — o par original/modificado daquele arquivo.
- **Diff combinado** — todas as seções de uma vez, com árvore lateral para navegar.
- **Modo Alterações** — a própria aba de edição vira o diff, sem abrir uma aba separada.

## Buscas

Há três buscas com alcances diferentes, e confundi-las é a fonte mais comum de resultado inesperado:

| Busca | Alcance |
|---|---|
| **Filtrar por nome** | Os nomes de arquivo e pasta da árvore |
| **Buscar no conteúdo** | O texto dentro dos arquivos do workspace |
| **Ir para arquivo** | Uma paleta que abre um arquivo pelo nome, com ranking |

## O que é salvo e o que não é

- **Autosave** existe, mas não para todo tipo de aba: abas de diff combinado e de revisão de conflito não têm autosave.
- **Alterações externas** ao app interrompem o autosave e pedem decisão.
- **Renomear** move o arquivo; **duplicar** cria uma cópia; **apagar** remove. As três mexem no disco de verdade.

## Por onde seguir

- [Abrir e visualizar arquivos](/docs/pt-br/ferramentas/arquivos/abrir-e-visualizar/)
- [A árvore e o status do git](/docs/pt-br/ferramentas/arquivos/arvore-e-status/)
- [Buscar arquivos e conteúdo](/docs/pt-br/ferramentas/arquivos/buscar/)
- [O editor](/docs/pt-br/ferramentas/arquivos/editor/)
- [Referência de comandos de arquivos](/docs/pt-br/ferramentas/arquivos/referencia-cli/)