---
id: "arquivos-importar-e-baixar"
titulo: "Importar e baixar arquivos"
resumo: "Trazer arquivos de fora do workspace, o que acontece em colisão de nome e como baixar um arquivo de um worktree remoto."
idioma: "pt-br"
tipo: "guia"
categoria: "arquivos-git"
aplicavelDesde: "0.0.16"
capabilities: ["fileTree.import.upload", "fileTree.download"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/pt-br/ferramentas/arquivos/importar-e-baixar/"
fonte: "pt-br/ferramentas/arquivos/importar-e-baixar.md"
caminhoPublico: "docs/publica/pt-br/ferramentas/arquivos/importar-e-baixar.md"
hashFonte: "sha256:f6499de29d406c5834831939fbcecfaba553707dcacda921bd59c4aa4cc6949b"
hashDestaPagina: "sha256:f6499de29d406c5834831939fbcecfaba553707dcacda921bd59c4aa4cc6949b"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
## Importar arquivos do sistema

O caminho é **arrastar arquivos de fora do app e soltá-los sobre a árvore**.

- O destino é a pasta sob o cursor no momento da soltura.
- Os arquivos entram na pasta do **workspace**.
- Arquivos soltos por arrastar e soltar do sistema chegam ao app por um canal próprio do sistema operacional, não pelo mesmo mecanismo de arrastar interno da árvore.

### O que esperar da cópia

- Os nomes são planejados **antes** da cópia, e a cópia é feita item por item.
- Existe **progresso e cancelamento** no fluxo de importação.
- Ao terminar, o resultado é resumido.

> **Limitação conhecida:** o painel Arquivos inicia a importação **sem mostrar a decisão de conflito nem o progresso**. Os diálogos que pediriam decisão em colisão de nome não aparecem nesse painel.
>
> **Consequência prática:** uma colisão de nome pode chegar **sem uma tela de decisão** para você escolher entre substituir, renomear ou cancelar. Trate isso como limitação em aberto — antes de importar algo que possa colidir, prefira importar para uma pasta vazia e mover depois.

## Baixar de um worktree remoto

Quando o workspace está num host remoto, a linha do arquivo oferece **baixar**.

- A ação só faz sentido com alvo remoto: **sem alvo remoto, não há o que baixar**.
- O arquivo é trazido do host remoto para o sistema local.
- O download não altera o arquivo no remoto.

## Limites

- **Importar não substitui arquivos de forma atômica** em runtime de ambiente: a substituição de um arquivo existente não é garantida como operação única.
- **Cancelar no meio** interrompe a sequência; o que já foi copiado permanece.
- A importação **não** passa pelo git: o que entra fica como arquivo novo ou modificado, e aparece como alteração no status.

## Relacionados

- [A árvore e o status do git](/docs/pt-br/ferramentas/arquivos/arvore-e-status/)