Guia Essencial: Como Abrir seu Projeto Frappe (WSL) no VS Code
O desenvolvimento com Frappe no Windows se torna incrivelmente poderoso quando integramos o VS Code ao WSL. Este guia mostra o fluxo de trabalho exato para abrir seu projeto da maneira correta, garantindo que você use as ferramentas do Linux dentro da interface do Windows.
Pré-requisitos
- Visual Studio Code instalado no Windows (com a opção "Adicionar ao PATH" marcada na instalação).
- Extensão "WSL" da Microsoft instalada no VS Code.
- Seu ambiente com Ubuntu e Frappe Bench já inicializado no diretório
/home/frappe/frappe-bench.
Passo 1: Iniciar o VS Code e Conectar ao WSL
Em vez de abrir o projeto diretamente, primeiro conectamos o VS Code ao ambiente Linux.
- Abra o Visual Studio Code no seu Windows da forma normal.
- No canto inferior esquerdo, clique no ícone verde com o símbolo
><. - Na paleta de comandos que aparece no topo, selecione a opção "Conectar ao WSL".
- Uma nova janela do VS Code será aberta. Observe que o ícone verde agora mostrará "WSL: Ubuntu-22.04". Isso confirma que a conexão está ativa.
Passo 2: Abrir a Pasta Correta do Projeto
Este é o passo mais importante. Não abra a pasta do seu usuário padrão ou do `root`. Você precisa abrir a pasta onde o projeto Frappe foi criado.
- Na janela do VS Code já conectada ao WSL, vá ao menu Arquivo > Abrir Pasta... (File > Open Folder...).
- Na caixa de diálogo, navegue até o caminho exato do seu projeto. O caminho é:
/home/frappe/frappe-bench - Selecione a pasta `frappe-bench` e clique em OK.
- A barra lateral do explorador será preenchida com as pastas do seu projeto (`apps`, `sites`, etc.).
Passo 3: Usar o Terminal Integrado (Com o Usuário Correto)
Agora que o projeto está aberto, você pode gerenciar tudo pelo terminal integrado do VS Code.
- Abra o terminal integrado com o atalho
Ctrl + `(a tecla de crase). -
O terminal será aberto, mas pode estar logado como seu usuário padrão do WSL ou como `root`. Para executar comandos do `bench` com segurança, sempre troque para o usuário `frappe`:
su - frappe - Após a troca, seu prompt mudará para `frappe@NOME-DO-PC:~$`. Agora, navegue para o diretório do projeto:
cd frappe-bench/
Conclusão: Você Está Pronto!
Parabéns! Seu ambiente está perfeitamente configurado. A partir deste terminal, dentro do VS Code, você pode executar todos os seus comandos, como bench start para iniciar o servidor. Você pode editar os arquivos na interface do VS Code e ver as mudanças refletidas em tempo real.