Skip to content

Guia rápido para instalação do WSL mais um conjunto de ferramentas (zshell, oh my zsh e power10k) para facilitar e melhorar a experiência de desenvolvimento em um ambiente Windows.

danielcorreia-dev/wsl-zsh-quickstart

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 

Repository files navigation

Guia para instalação WSL, Oh my ZSH + PowerLevel10k

Guia e tutorial para a utilização do Linux dentro do ambiente Windows com plugins e funcionalidades visando a melhor experiência para desenvolvimento. banner-stack-linux

Sumário

Recomendações Iniciais

O que é WSL?

WSL significa "Windows Subsystem for Linux" é uma camada de compatibilidade dentro do sistema operacional Windows que permite a execução de aplicativos Linux diretamente no Windows, sem a necessidade de uma máquina virtual separada. Isso permite que os usuários executem aplicativos e ferramentas Linux em seus sistemas Windows sem ter que instalar um sistema operacional Linux separado.

No ano de 2019, a Microsoft divulgou uma nova edição do WSL, conhecida como WSL 2. Essa nova versão apresentou melhorias em relação à primeira:

  • Capacidade de executar o kernel completo do Linux.
  • Melhoria no desempenho de acesso aos arquivos internos do Linux.
  • Compatibilidade completa com as chamadas de sistema. O lançamento oficial do WSL 2 ocorreu em 28 de maio de 2020.

Para entender as diferenças entre as versões, consulte o seguinte link: https://docs.microsoft.com/pt-br/windows/wsl/compare-versions

Por que usar WSL 2 para desenvolvimento?

Existem várias razões pelas quais o WSL pode ser uma excelente escolha para desenvolvimento de software:

  1. Acesso a ferramentas Linux - O WSL permite que os desenvolvedores acessem e usem as ferramentas de linha de comando do Linux, muitas das quais são amplamente utilizadas na comunidade de desenvolvimento de software, como o Git, Vim, GCC, entre outras. Isso pode ser útil para desenvolvedores que estão acostumados a trabalhar em ambientes Linux e querem continuar usando essas ferramentas no Windows.

  2. Suporte para ambientes de desenvolvimento populares do Linux - O WSL suporta ambientes de desenvolvimento populares do Linux, como o Ruby on Rails, o Node.js e o Python. Isso significa que os desenvolvedores podem continuar usando esses ambientes de desenvolvimento populares sem ter que mudar para o Linux.

  3. Facilidade de configuração - O WSL é fácil de configurar e usar, os desenvolvedores podem instalar rapidamente suas ferramentas de desenvolvimento favoritas, sem ter que passar por todo o processo de configuração de um ambiente Linux completo.

Em resumo, o WSL pode ser uma excelente escolha para desenvolvimento de software, permitindo que os desenvolvedores acessem ferramentas, suportem e configurem ambientes de desenvolvimento populares do Linux, e garantam a compatibilidade com o Windows.

Instalação do WSL 2

Windows 11

Para instalar o WSL no Windows 11 ou Windows 10 na versão 2004 ou superior basta abrir um PowerShell ou um Prompt de comando e executar:

 wsl --install

Este comando irá instalar todas as dependências do WSL instalando o Ubuntu como o Linux padrão.

Se você quiser instalar uma distribuição diferente, execute o comando wsl -l -o , será listado todas as versões de Linux disponíveis. Instale a versão escolhida com o comando wsl --install -d nome-da-distribuicao.

Recomendamos manter-se com Ubuntu por ser uma distribuição popular e que já vem com diversas ferramentas pré-instaladas.

Windows 10

Caso você esteja em uma versão mais antiga do Windows 10, execute os seguintes comandos no PowerShell em modo administrador:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Abra o PowerShell e digite o comando wsl, se não funcionar reinicie sua máquina.

Definindo WSL 2 como sua versão padrão

Abra o Terminal/PowerShell e execute este comando:

wsl --set-default-version 2

⚠️ Caso mostre que você não tenha o Kernel

Faça o download do Kernel 2 do WSL 2 nesse link: https://docs.microsoft.com/pt-br/windows/wsl/wsl2-kernel e instale o pacote.

Escolha sua distro pela Microsoft Store

Na Microsoft Store há diversas opções distribuições Linux para você baixar e utilizar.

microsoft-store-print

Ao iniciar o Linux instalado, você deverá criar um nome de usuário, que pode ser o mesmo da sua máquina, e uma senha, este será o usuário root da sua instância WSL.


Se tudo deu certo até aqui, parabéns, seu WSL2 já está funcionando! 🥳

O que é Z shell?

Z Shell, também conhecido como zsh, é um interpretador de comandos de shell para sistemas Unix-like, como Linux e macOS. Ele é uma alternativa mais poderosa e avançada ao shell padrão Bash.

O Z Shell tem muitos recursos úteis, incluindo autocompletar, histórico de comandos aprimorado, substituição de nomes de arquivos com wildcards (expressões regulares), suporte a várias abas e janelas, personalização da aparência e do comportamento do shell e muito mais. Além disso, ele tem um sistema de plugin robusto que permite estender ainda mais suas funcionalidades.

Outro recurso útil do Z Shell é o seu "prompt de diretório", que mostra o diretório atual em que o usuário está trabalhando no shell, bem como outras informações relevantes. Isso pode ajudar a evitar erros ao executar comandos em diretórios errados e a tornar o trabalho no shell mais eficiente.

O Z Shell pode ser instalado em muitas distribuições Linux e macOS por meio de gerenciadores de pacotes ou por meio de download direto do site oficial. Ele é frequentemente recomendado para usuários avançados de linha de comando que desejam uma experiência de shell mais poderosa e personalizável.

Por que utilizar o ZSH vai melhorar a sua experiência utilizando o terminal?

  • Personalização: o Z Shell é altamente personalizável e você pode ajustar muitas configurações para adaptar o shell às suas preferências. Isso pode incluir personalizar o prompt, criar aliases para comandos frequentemente usados, configurar atalhos de teclado personalizados e muito mais. Neste guia irei mostrar o PowerLevel10k um plugin versátil, extremamente útil que deixará está funcionalidade de customização visual super simples de ser feita e que possivelmente irá cobrir a maioria das suas necessidades.

  • Compatibilidade com Bash: o Z Shell é compatível com a maioria dos comandos do Bash, o que significa que você pode usar scripts e comandos existentes sem precisar reescrevê-los. Além disso, o Z Shell tem recursos adicionais que o Bash não possui, portanto, você pode aproveitar o melhor dos dois mundos.

Instalando ZSH

Para instalar o Z Shell abra o app Terminal do Windows para acessar o seu WSL

windows-terminal-search

No terminal, em ambiente Linux, atualize os seus pacotes e dê upgrade nos programas do seu sistema utilizando os comandos abaixo:

sudo apt update && sudo apt upgrade

Ubuntu, Debian & derivatives (Windows 10 WSL | Native Linux kernel with Windows 10 build 1903)
Para instalar o zshell utilize:

sudo apt install zsh

Para checar se o zsh foi devidamente instalado, reinicie seu terminal e digite, zsh --version , o comando deve retornar algo similar à: zsh 5.8.1

O que é Oh My Zsh?

Oh My Zsh é um framework de código aberto para gerenciar sua configuração do Z Shell (zsh). Ele fornece uma maneira fácil de instalar e gerenciar temas, plugins e outras configurações do Z Shell. Com o Oh My Zsh, você pode personalizar facilmente a aparência e o comportamento do seu shell, adicionar novas funcionalidades e tornar sua experiência de linha de comando mais produtiva e agradável.

O Oh My Zsh vem com vários recursos úteis pré-instalados, como autocompletar, sugestões de comandos, substituição de nomes de arquivos com wildcards, temas de aparência atraente e muito mais. Além disso, existem centenas de plugins disponíveis para o Oh My Zsh, que podem ser facilmente adicionados e configurados para atender às suas necessidades.

Vamos utilizar o Oh My Zsh para instalar o PowerLevel10k, um plugin que vai deixar nosso terminal charmoso e intuitivo, mostrando diretorios e status do Git utilizando ícones e horários diretamente nas linhas de escrita do prompt.

Oh My Zsh

Pré-requisitos:

  • Ter Git instalado (Por padrão o WSL - Ubuntu já vem com o Git instalado, mas caso queira se certificar digite git --version no seu terminal).

  • Ter curl ou wget instalados (Neste guia iremos utilizar curl).

⚠️ Caso o Git não esteja instalado no seu WSL, utilize:

sudo apt update && sudo apt upgrade
sudo apt install git

CURL

Vamos utilizar o curl, uma ferramenta de linha de comando que permite realizar transferência de dados de e para servidores por meio de vários protocolos de rede, incluindo HTTP, HTTPS, FTP, SMTP, POP3 e muitos outros, para baixar e instalar o Oh My ZSH.

Para instalar o curl basta somente fazer os mesmos passos feitos utilizados para a instalação do zsh:

sudo apt install curl

Para checar se foi devidamente instalado execute o comando: curl --version

Instalando OhMyZsh

Para instalar Oh My Zsh basta digitar este comando no terminal e reinciar a janela do WSL.

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

PowerLevel10k

Antes de prosseguir com a instalação é ideal:

  • Instalar uma fonte adequada.
  • Fazer todos os passos anteriores a este.

O que o PowerLevel10k faz?

É um tema para o ZSH, que enfatiza velocidade, flexibilidade e uma experiência fora da caixa, voltada principalmente para a customização do seu terminal.

Instalando o PowerLevel10k

A maneira mais simples de instalar é utilizando o git, desta forma bastar executar o código no terminal e reiniciar a janela para entrar no modo de configuração.

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ~/powerlevel10k
echo 'source ~/powerlevel10k/powerlevel10k.zsh-theme' >>~/.zshrc

Wizard e Customização

Após reiniciar a janela, um wizard deve aparecer no seu terminal para selecionar opções de customização estéticas, a partir daqui vai de seu bom gosto e preferência, caso queira repetir o processo de setup utilize:

p10k configure

terminal-show-config

ZSH Plugins

Agora que seu combo setup está pronto, WSL2 + zsh + powerlevel10k, podemos colocar a valer as ferramentas a nossa disposição. Aqui vou somente mostrar como instalar dois plugins que são em minha opnião indispensáveis, mas vale ressaltar que as opções de customização são praticamente ilimitadas e que você pode adicionar quantos plugins desejar.

zsh-syntax-highlighting & zsh-autosuggestions

Execute os dois comandos abaixo para instalar o zsh-autosuggestions e o zsh-syntax-highlighting, respectivamente.

git clone https://github.com/zsh-users/zsh-autosuggestions.git $ZSH_CUSTOM/plugins/zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git $ZSH_CUSTOM/plugins/zsh-syntax-highlighting

Depois de instalados, vá para nano ~/.zshrc e ache plugins=(git) e adicione os plugins desta forma:

plugins=(git zsh-autosuggestions zsh-syntax-highlighting)
  • Reabra o terminal ou digite source .zshrc e pronto. 🥳

Adicionais

Já que você está dentro de um ambiente Linux, recomendamos que você instale algumas ferramentas que vão ser úteis de maneira geral, tanto para a área de desenvolvimento, como a utilização do terminal em si.

  1. neofetch
  2. tree
  3. nvm
  4. npm
  5. vim
  6. nnn
  7. pip
  8. bat
  9. fd
  10. zoxide

Visual Studio Code

Uma das grandes vantagens de se utilizar o WSL2 é a interatividade com o VSCode, desta forma, é possível usar a IDE para manipular os arquivos e diretórios dentro do Linux, além de usar o terminal para gerenciar pacotes e ver status do git dos seus projetos em tempo real de desenvolvimento.

Pré-requisitos

  • Já ter instalado o VSCode na sua máquina
  • Instalar a extensão WSL no Visual Studio Code

wsl-extension-pic

Utilização

Após ter instalado o VSCode e a extensão WSL, dentro do terminal basta executar:

code nome-do-arquivo

O Ubuntu irá abrir o diretório/arquivo no VSCode em ambiente Linux. Caso tudo corra de maneira correta, no canto inferior esquerdo você verá uma tag em azul com o nome similar à: WSL: Ubuntu e o seu terminal integrado no VSCode funcional em Linux.

wsl-working

Fonte ideal

Para usar de todas as funcionalidades da melhor maneira é necessário instalar uma fonte que possua ligaduras e ícones. Neste caso, as melhores fontes a serem utilizadas são as Nerd Fonts, para usar elas entre no site deles, escolha uma fonte e instale em sua máquina.

Configurando fontes no Terminal Windows

A configuração dentro do terminal Windows é feita a partir dos perfis, desta forma, abra a configurações pressionando Ctrl + , ou clicando na setinha ao lado da aba para selecionar a opção. No perfil Ubuntu procure no menu a opção de Aparência, dentro dele, procure pela opção de fontes e altere para a que você baixou.

dropdown-terminal-menu

Configurando fonte no VSCode

Se seu terminal e WSL estão funcionando mas você não está conseguindo visualizar os ícones dentro do terminal integrado do VSCode, basta somente uma simples configuração nas configurações de usuário para solucionar isso.

Dentro do VSCode, abra a palheta de comando, ctrl + shift + p , e procure por Preferences: Open User Settings (JSON) ou Preferências: Abrir as Configurações do Usuário (JSON) caso use o VSCode em português.

Nas linhas do editor você verá uma estrutura de JSON, basta adicionar uma nova linha e digitar:

  "terminal.integrated.fontFamily": "nome-da-fonte",

⚠️ Lembre-se de digitar o exato nome da fonte para que funcione corretamente

  • Para checar as fontes instaladas no seu computador basta pesquisar na barra de pesquisa do Windows o termo Fontes ou abrir o Painel de Controle e selecionar o icone Fontes.

⚠️ O Terminal do VSCode só possui suporte com fontes mono

Requisitos Mínimos

Para executar o WSL2 (Windows Subsystem for Linux 2) em um sistema operacional Windows 10, você precisa cumprir os seguintes requisitos mínimos de sistema:

  • Windows 10, versão 1903 ou superior - Certifique-se de que seu sistema operacional Windows 10 esteja atualizado para a versão 1903 ou superior. Para verificar a versão do seu Windows, pressione a tecla Windows + R, digite "winver" e pressione Enter.

  • Processador de 64 bits com suporte para virtualização - O WSL2 requer um processador de 64 bits com suporte para virtualização de hardware. Verifique se a virtualização está habilitada no BIOS do seu computador.

  • Pelo menos 4 GB de RAM - É recomendável ter pelo menos 4 GB de RAM para executar o WSL2.

  • 5 GB de espaço livre em disco - O WSL2 requer pelo menos 5 GB de espaço livre em disco para ser instalado.

Referências

About

Guia rápido para instalação do WSL mais um conjunto de ferramentas (zshell, oh my zsh e power10k) para facilitar e melhorar a experiência de desenvolvimento em um ambiente Windows.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published