Arquivos locais Windows e projetos WSL legados

Abra uma pasta de projeto Windows e preserve um projeto WSL anterior ao transferir seus arquivos salvos.

No Digital Design Studio para Windows 2.1.2.3, abra uma pasta armazenada neste PC em Local → Projetos neste PC → Abrir pasta de projeto. As seções sobre WSL legado abaixo descrevem a recuperação em uma instalação anterior. Preserve a distribuição original e os arquivos salvos enquanto prepara uma cópia verificada.

Preservar e migrar um projeto existente

Mantenha a distribuição, os arquivos, os dados do Git e o trabalho não salvo originais até concluir a recuperação e uma exportação/cópia verificada. Confira hashes, nomes que diferenciam maiúsculas de minúsculas, colisões, links e a propriedade no destino. Transações não resolvidas devem ser recuperadas pelo seu proprietário original. Identidades Linux de inode/UID, confiança de licença/dispositivo, qualificações assinadas de execução e journals de transações não constituem autoridade do Windows ou da Cloud. Não exclua uma distribuição nem abra silenciosamente um caminho WSL como raiz do Windows.

Legado: Escolher o local correto do projeto

Um projeto WSL mantém o código-fonte e o trabalho dos engines Linux no sistema de arquivos Linux da distribuição selecionada. O aplicativo Windows fornece a janela, o editor e a conexão. Um projeto local do Windows usa outro adaptador; escolha o host deliberadamente antes de editar.

Use uma distribuição WSL2 Ubuntu 24.04 x86-64 existente com um usuário padrão que não seja root. Mantenha o projeto no diretório do usuário Linux, como /home/your-user/projects/demo. /mnt/c e compartilhamentos de rede não atendem a esse contrato de espaço de trabalho Linux.

Legado: Verificar e conectar

PowerShell

wsl --list --verbose
  1. Confirme que a distribuição pretendida está listada como WSL versão 2. A conexão do projeto no aplicativo não instala uma distribuição.

  2. Selecione o projeto Linux pelo aplicativo Windows usando seu caminho de projeto WSL, por exemplo \\wsl.localhost\Ubuntu-24.04\home\your-user\projects\demo.

  3. Se o aplicativo instalado oferecer preparação do backend, revise-a e use o backend incluído correspondente. Um auxiliar substituído manualmente pode ser incompatível.

  4. Confirme a distribuição, o usuário, a raiz do projeto e o estado da conexão. Abra e salve um pequeno arquivo de texto antes de realizar uma transação ou executar um engine.

Legado: Arquivos, Git e engines

Textos salvos, configurações de projeto e operações compatíveis de controle de versão são executados pelo espaço de trabalho Linux. Gravações de arquivos verificam a revisão salva. Leituras e edições do Git via WSL usam o Git Linux desse projeto. Um espaço de trabalho conectado não habilita todos os engines, visualizadores binários ou transferências remotas do Git; confira a ação exibida pelo host instalado.

Legado: Reconectar após mudanças

Mudança ou mensagem

Recuperação

WSL reiniciado

Preserve o texto não salvo, reconecte explicitamente e leia os arquivos novamente antes de salvar.

Diretório do projeto movido ou substituído

Reabra o diretório pretendido; não reutilize uma conexão antiga para uma nova identidade de pasta.

Usuário root, permissões compartilhadas ou montagem do Windows rejeitados

Selecione uma pasta Linux pertencente ao usuário com o usuário pretendido que não seja root.

Resultado do salvamento incerto

Recarregue e inspecione o conteúdo salvo atual antes de repetir a gravação.

Consulte Instalação no Windows, Espaços de trabalho locais e Diagnósticos para os passos de pacote, backup e relato de erros.

Suporte a ambientes

Usar uma pasta Windows

  1. Escolha Local → Projetos neste PC → Abrir pasta de projeto. Selecione uma pasta Windows comum para o projeto. Este host não abre caminhos WSL.

  2. Confira a raiz do projeto, salve uma alteração inofensiva na fonte e reabra-a. As ferramentas locais do Free, incluindo o Git local, funcionam sem autenticação; autentique-se para usar IA, Cloud, Git remoto e serviços da conta. My PC não exige licença de dispositivo.

  3. As etapas WSL acima são para um aplicativo antigo que oferece essa conexão. Recupere e verifique o projeto original nele antes de copiar arquivos; mantenha a distribuição original e não copie credenciais nem diários de transações como autorização.