Archivos locales de Windows y proyectos WSL heredados

Abra una carpeta de proyecto de Windows y conserve un proyecto WSL anterior al trasladar sus archivos guardados.

En Digital Design Studio para Windows 2.1.2.3, abra una carpeta guardada en este PC desde Locales → Proyectos en este PC → Abrir carpeta de proyecto. Las secciones sobre WSL heredado que aparecen a continuación describen la recuperación en una instalación anterior. Conserve la distribución original y los archivos guardados mientras prepara una copia verificada.

Preservar y migrar un proyecto existente

Conserve la distribución original, los archivos, los datos Git y el trabajo sin guardar hasta completar la recuperación y una exportación/copia verificada. Compruebe hashes, nombres sensibles a mayúsculas, colisiones, enlaces y propiedad del destino. Su propietario original debe recuperar las transacciones sin resolver. La identidad de inodo/UID de Linux, la confianza de licencia/dispositivo, las calificaciones firmadas de ejecución y los diarios de transacciones no son autorización de Windows ni Cloud. No elimine una distribución ni abra silenciosamente una ruta WSL como raíz de Windows.

Heredado: Elegir la ubicación adecuada del proyecto

Un proyecto WSL conserva el código fuente y el trabajo del motor Linux en el sistema de archivos Linux de la distribución seleccionada. La aplicación Windows proporciona la ventana, el editor y la conexión. Un proyecto local de Windows usa otro adaptador; elija el host deliberadamente antes de editar.

Use una distribución WSL2 Ubuntu 24.04 x86-64 existente con un usuario predeterminado sin privilegios root. Mantenga el proyecto en el directorio del usuario Linux, como /home/your-user/projects/demo. /mnt/c y los recursos compartidos de red no cumplen este contrato de espacio de trabajo Linux.

Heredado: Comprobar y conectar

Powershell

wsl --list --verbose
  1. Confirme que la distribución prevista figura como WSL versión 2. La conexión del proyecto de la aplicación no instala una distribución.

  2. Seleccione el proyecto Linux desde la aplicación Windows mediante su ruta de proyecto WSL, por ejemplo \\wsl.localhost\Ubuntu-24.04\home\your-user\projects\demo.

  3. Si la aplicación instalada ofrece preparar el backend, revíselo y use el backend incluido correspondiente. Un asistente sustituido manualmente puede ser incompatible.

  4. Confirme la distribución, el usuario, la raíz del proyecto y el estado de conexión. Abra y guarde un archivo de texto pequeño antes de realizar una transacción o ejecutar un motor.

Heredado: Archivos, Git y motores

El texto guardado, los ajustes del proyecto y las operaciones compatibles de control de versiones se ejecutan mediante el espacio de trabajo Linux. Las escrituras comprueban la revisión guardada. Las lecturas y ediciones Git respaldadas por WSL usan Git de Linux para ese proyecto. Un espacio conectado no habilita todos los motores, visores binarios ni transferencias remotas Git; compruebe la acción que muestra su host instalado.

Heredado: Reconectar tras cambios

Cambio o mensaje

Recuperación

WSL se reinició

Conserve el texto sin guardar, reconecte explícitamente y vuelva a leer los archivos antes de guardar.

El directorio del proyecto se movió o reemplazó

Vuelva a abrir el directorio previsto; no reutilice una conexión antigua para una identidad de carpeta nueva.

Se rechazó el usuario root, los permisos compartidos o el montaje de Windows

Seleccione una carpeta Linux propiedad del usuario con el usuario previsto sin privilegios root.

El resultado de guardado es incierto

Vuelva a cargar e inspeccione el contenido guardado actual antes de repetir la escritura.

Consulte Instalación en Windows, Espacios de trabajo locales y Diagnósticos para los pasos de paquetes, respaldo y comunicación de errores.

Compatibilidad de entornos

Use una carpeta de Windows

  1. Elija Locales → Proyectos en este PC → Abrir carpeta de proyecto. Seleccione una carpeta normal de Windows para el proyecto. Este host no abre rutas WSL.

  2. Compruebe la raíz del proyecto, guarde una modificación inocua del código fuente y vuelva a abrirlo. Las herramientas locales de Free, incluido Git local, funcionan sin iniciar sesión; inicie sesión para usar IA, Cloud, Git remoto y los servicios de la cuenta. My PC no necesita una licencia de dispositivo.

  3. Los pasos WSL anteriores corresponden a una aplicación antigua que ofrece esa conexión. Recupere y verifique allí el proyecto original antes de copiar archivos; conserve la distribución original y no copie credenciales ni diarios de transacciones como autorización.