Ubuntu 16.04 / Como instalar Sass

Para instalar o Ruby Sass legado no Ubuntu 16.04, você pode usar o pacote ruby-sass do APT ou a gem sass do RubyGems. No entanto, Ruby Sass é uma implementação descontinuada, então deve ser considerado apenas ao reproduzir projetos existentes, e para novos ambientes de desenvolvimento, utilize um SO atualmente suportado e o Dart Sass. A instalação via gem também não instala o Dart Sass mais recente.

Verifique a implementação e o suporte do SO antes de instalar

Sass é uma ferramenta que converte folhas de estilo escritas com variáveis e regras aninhadas em CSS (Folhas de Estilo em Cascata). SCSS é uma sintaxe do Sass semelhante ao CSS, usando chaves, e a extensão do arquivo é .scss. Mesmo com o mesmo nome de comando sass, Ruby Sass e Dart Sass são implementações diferentes.

De acordo com o guia oficial do Sass, Ruby Sass atingiu o fim de seu suporte em 2019. O Ubuntu 16.04 também encerrou seu suporte padrão e a manutenção de segurança expandida (Expanded Security Maintenance, ESM), e em outubro de 2026, suporte adicional de segurança requer a verificação das condições do serviço Legacy do Ubuntu Pro. O escopo de suporte do sistema operacional pode ser encontrado em guia do Ubuntu 16.04 da Canonical.

Primeiro, faça backup do seu código-fonte e do CSS existente, e verifique as implementações e versões usadas nos arquivos Gemfile.lock, package.json, etc., do projeto. Os dois métodos antigos de instalação abaixo são alternativas, portanto não há necessidade de instalar ambos.

Instale o Ruby Sass legado com APT

Para reproduzir o pacote de distribuição usado no Ubuntu 16.04, verifique no terminal na seguinte ordem. Você precisa de uma conta que possa executar sudo e de acesso a um repositório APT que funcione corretamente.

sudo apt update
apt-cache policy ruby-sass
sudo apt install ruby-sass
sass --version

O campo Candidate em apt-cache policy mostra a versão do pacote selecionada para instalação. Se não houver candidatos ou se a atualização falhar, não presuma que a instalação seja possível; primeiro verifique as configurações do repositório, a rede e o status de suporte do ambiente. Não adicione arbitrariamente um repositório ou desative a verificação de assinatura apenas porque um pacote não pode ser encontrado.

Após a instalação, a versão do Sass deve ser exibida. A versão do pacote de distribuição pode diferir da versão do gem, e Sass 3.4.23 (Selective Steve) de postagens anteriores é um exemplo de saída passada. O resultado da instalação atual não precisa necessariamente corresponder àquela string.

Instale a versão legada necessária com RubyGems

Este é um método para revisar quando um projeto existente requer a gem Ruby Sass. Abaixo está um exemplo especificando 3.7.4, e se o projeto exigir uma versão diferente, dê prioridade a esse requisito. As informações do RubyGems sobre Sass 3.7.4 indicam que o Ruby 2.0.0 ou superior é necessário, mas esta condição sozinha não significa que todas as gems dependentes podem ser instaladas em versões mais antigas do Ruby.

sudo apt update
sudo apt install ruby
ruby --version
gem --version
gem install --user-install sass -v 3.7.4 --no-document

--user-install é uma opção para instalá-lo no diretório de gems do usuário em vez de no sistema inteiro. Se um aviso mostrar que o executável não pode ser encontrado, siga o guia de instalação por usuário do RubyGems e adicione o bin do diretório ao seu PATH. No Bash, você pode aplicar o seguinte comando no seu terminal atual e, em seguida, verificar.

export PATH="$(ruby -r rubygems -e 'print Gem.user_dir')/bin:$PATH"
sass --version

Se esta for uma configuração que você continuará a usar, adicione a linha export acima ao ~/.bashrc uma vez e verifique em um novo terminal. Para reverter, remova a linha adicionada e reabra o terminal. Se a instalação falhar, verifique os gems dependentes e a versão do Ruby mostrados no erro, e reproduza o ambiente com base no arquivo de bloqueio armazenado no projeto e no ambiente da época. Não desative a verificação HTTPS para resolver erros de certificado ou TLS.

Verifique a instalação convertendo SCSS para CSS

Apenas imprimir a versão não confirma a conversão real. Em uma pasta de trabalho separada e vazia, crie um arquivo style.scss e salve o conteúdo inteiro abaixo. Em uma pasta com arquivos existentes, primeiro certifique-se de que não haja conflito com os nomes dos arquivos de exemplo existentes.

$brand: #336699;

.notice {
  color: $brand;
  strong {
    font-weight: 700;
  }
}

Executar o seguinte comando nessa pasta irá gerar style.css.

sass style.scss style.css

O CSS gerado deve conter os seletores e valores abaixo. Dependendo da implementação e das configurações de formato de saída, espaços, quebras de linha ou comentários de mapa de origem podem variar.

.notice {
  color: #336699;
}

.notice strong {
  font-weight: 700;
}

Altere os valores de cores e converta novamente para ver se os valores no CSS mudam, confirmando a relação entre os arquivos de entrada e saída. Reverter para os valores originais e executar novamente restaurará o estado do exemplo. A conversão Sass é o processo de criação de arquivos CSS, e para aplicá-lo em uma página web, você precisa carregar o CSS de saída no HTML correspondente.

Quando os comandos entram em conflito ou a instalação precisa ser revertida

Se sass: command not found aparecer após a instalação, verifique se a instalação foi bem-sucedida e revise o PATH. Se aparecer uma versão diferente da esperada, veja qual executável é selecionado primeiro—se instalado via APT, gem do usuário ou outra ferramenta.

command -v sass
type -a sass
sass --version

Colocar o bin da gem do usuário na frente do PATH pode dar prioridade a esse comando. Em ambientes com instalações duplicadas via APT e gem, não olhe apenas para o número da versão; registre também o caminho. Em vez de deletar arquivos arbitrariamente, remova-os usando a ferramenta de gerenciamento usada para a instalação.

• Para reverter uma instalação via APT, use sudo apt remove ruby-sass. Antes de executar, leia a lista de itens a serem removidos e verifique se não estão em uso por outros projetos.
• Para remover a gem do usuário no exemplo acima, use gem uninstall --user-install sass -v 3.7.4. Não há necessidade de remover outras versões ou dependências compartilhadas em massa.
• Se o erro for causado por sintaxe SCSS moderna incompatível, simplesmente reinstalar pode não resolvê-lo. Compile com a implementação exigida pelo projeto ou revise o código para mudar para Dart Sass.

Mude para Dart Sass em um novo ambiente

A implementação de referência atual do Sass é o Dart Sass. A documentação oficial de instalação orienta você a instalar uma distribuição autônoma ou uma instalação via npm adequada para seu sistema operacional e CPU. O exemplo de npm nesta seção deve ser executado em um ambiente de desenvolvimento separado preparado com sistemas operacionais suportados e o Node.js exigido pela versão correspondente do Sass, e não assume a execução no Node.js padrão do Ubuntu 16.04.

Uma vez que o Node.js e o npm estejam prontos, você pode instalar dependências de desenvolvimento específicas do projeto em uma nova pasta de projeto com o seguinte comando. Ao aplicar a um projeto existente, primeiro faça backup do package.json e do arquivo lock, depois verifique as configurações de build existentes.

npm init -y
npm install --save-dev sass
npx sass --version
npx sass style.scss style.css

Antes de executar o último comando, você deve salvar o style.scss da seção anterior na mesma pasta. O npx sass utiliza o Sass local do projeto instalado por este procedimento e pode diferir do comando e versão global do sass. Você pode verificar o resultado da instalação com npm ls sass e o CSS gerado. As dependências de desenvolvimento adicionadas neste exemplo podem ser removidas com npm uninstall --save-dev sass.

Ao transferir um projeto antigo, compare os resultados da conversão em um branch de teste ou cópia, e revise as diferenças de CSS e avisos antes de aplicá-los. Você pode verificar o comando e as opções para conversão de arquivo único na documentação do comando Dart Sass . Instalar o Ruby Sass e mudar para o Dart Sass atual são tarefas separadas.