# Yarn install: Como instalar o gerenciador de pacotes JavaScript

Para instalar o Yarn, primeiro é preciso instalar a versão completa e, em seguida, uma versão de projeto individual. Então, você pode configurar o gerenciador de pacotes de acordo com as suas necessidades.

## Instalar Yarn passo a passo

O gerenciador de pacotes Yarn para JavaScript foi desenvolvido para o ambiente de execução Node.js e, desde seu lançamento em 2016, tornou-se uma das opções mais populares nesse segmento. Já que a instalação e configuração do programa nem sempre são simples, apresentamos aqui um tutorial passo a passo de como instalar o Yarn. Para isso, você já precisa ter instalado o Node.js.

Dica Neste outro artigo, aprenda a [instalar o Node.js no Ubuntu](https://www.ionos.com/pt-br/digitalguide/sites-de-internet/desenvolvimento-web/install-nodejs-ubuntu-2204/).

### Pré-requisitos para instalar o Yarn

Existem poucos pré-requisitos para instalar o Yarn. Além do Node.js, você precisará de uma distribuição do Linux, por exemplo o Ubuntu, como sistema operacional. Também é necessário ter o **gerenciador de pacotes npm** e uma conta com [privilégios sudo](https://www.ionos.com/pt-br/digitalguide/servidor/configuracao/comando-sudo-do-linux/ "Comando sudo no Linux"). Caso você não saiba se possui o Node.js no seu sistema, pode verificar isso com este comando:

```bash
$ node -v
```

Assim, você verá qual versão está instalada no sistema. Após a confirmação, você já pode começar a instalar o Yarn.

### Baixar e instalar o Yarn

Para realizar o Yarn install, você deve basicamente instalar **duas versões do gerenciador de pacotes**. O primeiro passo é baixar a versão completa do programa. Desse modo, você garantirá que a mesma versão será usada para todas as etapas de trabalho e todos os membros da equipe. Isso minimiza o risco de erros. Para instalar a versão completa, o melhor é utilizar o gerenciador de pacotes npm. O comando para isso é o seguinte:

```bash
$ sudo npm install -g yarn
```

Então, consulte o número da versão, para ter certeza de que recebeu os pacotes mais recentes:

```bash
$ yarn --version
```

### Instalar o Yarn localmente

Em seguida, você deve instalar o Yarn para um projeto JavaScript específico. Para isso, primeiro acesse o diretório do seu projeto. No comando abaixo, substitua a expressão “seu-projeto” pelo nome real do projeto:

```bash
cd ~/seu-projeto
```

Caso você ainda não tenha uma pasta de projeto, basta criá-la com o comando `mkdir`:

```bash
mkdir seu-projeto
cd seu-projeto
```

Agora, use o comando `yarn set` para obter a versão Berry do Yarn:

```bash
$ yarn set version berry
```

A versão mais recente do **Yarn Berry** será baixada, se disponível. Salve-a em uma pasta de projeto com o nome `.yarn/releases` e crie um arquivo de configurações chamado `.yarnrc.yml`. A mensagem exibida será algo como:

```bash
Resolving berry to a url...
Downloading https://github.com/yarnpkg/berry/raw/master/packages/berry-cli/bin/berry.js...
Saving it into /home/user/seu-projeto/.yarn/releases/yarn-berry.cjs...
Updating /home/user/seu-projeto/.yarnrc.yml...
Done!
```

Então, verifique novamente a versão:

```bash
$ yarn --version
```

Se o Yarn Berry foi instalado corretamente, você verá o seguinte resultado (o número varia de acordo com a versão atual):

```bash
3.0.0
```

## Comandos mais importantes do Yarn

Imediatamente após executar o Yarn install, você já poderá começar a usar o gerenciador de pacotes. Para trabalhar com o Yarn de forma eficiente, vale a pena conhecer seus comandos básicos. Nas seções a seguir, apresentaremos resumidamente os mais importantes.

### Iniciar novo projeto

Para iniciar um novo projeto, utilize o comando `init`. Ele cria o novo projeto e todos os arquivos necessários:

```bash
yarn init
```

### Salvar e criar dependências

Se você já tem um projeto e deseja armazenar todas as dependências dentro dele, use o comando `yarn install`:

```bash
yarn install
```

Para adicionar novas dependências, basta usar o comando `add`. No código abaixo, substitua a expressão “nome-do-pacote” pelo nome do pacote desejado:

```bash
yarn add nome-do-pacote
```

### Configuração ideal para *.gitignore*

Todos os arquivos são salvos na pasta *.yarn* dentro do seu projeto. Porém, alguns desses arquivos podem ficar de fora. Para isso, use a seguinte configuração para o seu arquivo *.gitignore*:

```bash
.yarn/*
!.yarn/patches
!.yarn/releases
!.yarn/plugins
!.yarn/sdks
!.yarn/versions
.pnp.*
```

### Ajuda e mais informações

Se você precisar de ajuda ou de mais informações após instalar o Yarn, o melhor é usar o comando `--help`.

```bash
$ yarn --help
```

Caso você queira ajuda para um comando específico, pode simplesmente combiná-lo com `--help`. Por exemplo, se você deseja mais informações sobre o comando `yarn install`, digite:

```bash
$ yarn install --help
```

## Alternativas ao Yarn

O Yarn é uma solução muito recomendável para quem quer compartilhar ou utilizar código com segurança. Mas também existem boas alternativas ao Yarn, que podem cumprir as mesmas funções.

### npm

O npm (Node Package Manager) é uma das opções mais comuns para trabalhar com o Node.js. Ele é muito simples, rápido e seguro de usar, além de ser perfeitamente compatível com o ambiente de execução. Essa ferramenta oferece um **registro com mais de 1,3 milhão de pacotes**, bem como a interface CLI. Neste tutorial para o Yarn install, por exemplo, também utilizamos o npm.

### pnpm

O pnpm é outro gerenciador de pacotes *open source* totalmente adequado para trabalhar com JavaScript. Sua estrutura é semelhante à do npm, mas ele utiliza links simbólicos (*symlinks*) e não requer a instalação local de vários pacotes idênticos. Esse programa foi desenvolvido para oferecer uma **alternativa ainda mais eficiente ao npm**, sendo portanto uma opção interessante para substituir o Yarn.

### Bower

A terceira alternativa é o Bower, um gerenciador de pacotes gratuito para **desenvolvimento web do lado do cliente**. Portanto, ele foi otimizado para o trabalho no *front-end*. Para isso, também há uma grande diversidade de pacotes disponíveis. Além do JavaScript, esse gerenciador também permite trabalhar com outros componentes, como HTML e CSS. Ele é muito fácil de usar e funciona por uma linha de comando do Node.js.


This is a markdown version of: [https://www.ionos.com/pt-br/digitalguide/sites-de-internet/desenvolvimento-web/yarn-installation/](https://www.ionos.com/pt-br/digitalguide/sites-de-internet/desenvolvimento-web/yarn-installation/) for AI/LLM consumption.