---
id: "arquivos-importar-e-baixar"
titulo: "Importar y descargar archivos"
resumo: "Traer archivos de fuera del workspace, qué ocurre en una colisión de nombre y cómo descargar un archivo de un worktree remoto."
idioma: "es"
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/es/ferramentas/arquivos/importar-e-baixar/"
fonte: "pt-br/ferramentas/arquivos/importar-e-baixar.md"
caminhoPublico: "docs/publica/es/ferramentas/arquivos/importar-e-baixar.md"
hashFonte: "sha256:f6499de29d406c5834831939fbcecfaba553707dcacda921bd59c4aa4cc6949b"
hashDestaPagina: "sha256:54ed0532817be76b80cd351d74da82527cadfea33c8cb530d7e4aa5acb20520f"
traducaoAssistidaPorIA: true
traducaoDesatualizada: false
corpoRetido: false
---
<!-- traducao-assistida-por-ia: idioma=ES fonte=pt-br/ferramentas/arquivos/importar-e-baixar.md fonteHash=sha256:f6499de29d406c5834831939fbcecfaba553707dcacda921bd59c4aa4cc6949b estado=atual -->

## Importar archivos del sistema

El camino es **arrastrar archivos de fuera de la app y soltarlos sobre el árbol**.

- El destino es la carpeta bajo el cursor en el momento de soltar.
- Los archivos entran en la carpeta del **workspace**.
- Los archivos soltados por arrastrar y soltar nativo llegan a la app por un canal propio del sistema operativo, no por el mismo mecanismo de arrastre interno del árbol.

### Qué esperar de la copia

- Los nombres se planifican **antes** de la copia, y la copia se hace elemento por elemento.
- Hay **progreso y cancelación** en el flujo de importación.
- Al terminar, el resultado se resume.

> **Limitación conocida:** el panel Archivos inicia la importación **sin mostrar la decisión de conflicto ni el progreso**. Los diálogos que pedirían una decisión ante una colisión de nombre no aparecen en ese panel.
>
> **Consecuencia práctica:** una colisión de nombre puede llegar **sin una pantalla de decisión** para que elijas entre reemplazar, renombrar o cancelar. Trata esto como limitación abierta — antes de importar algo que pueda colisionar, prefiere importar a una carpeta vacía y mover después.

## Descargar de un worktree remoto

Cuando el workspace está en un host remoto, la fila del archivo ofrece **descargar**.

- La acción solo tiene sentido con objetivo remoto: **sin objetivo remoto, no hay nada que descargar**.
- El archivo se trae del host remoto al sistema local.
- La descarga no cambia el archivo en el remoto.

## Límites

- **Importar no sustituye archivos de forma atómica** en runtime de entorno: el reemplazo de un archivo existente no está garantizado como operación única.
- **Cancelar a mitad** interrumpe la secuencia; lo que ya se copió permanece.
- La importación **no** pasa por git: lo que entra queda como archivo nuevo o modificado, y aparece como cambio en el estado.

## Relacionados

- [El árbol y el estado de git](/docs/es/ferramentas/arquivos/arvore-e-status/)