Guia Completo de Instalação do Ruby para Iniciantes

Bem-vindo ao mundo da programação Ruby! Este guia completo o levará através da instalação do Ruby 3.x no Windows 11, macOS 13+ e distribuições Linux modernas. Ruby é uma linguagem de programação linda e expressiva que é perfeita para iniciantes e profissionais.

Índice

Introdução

Ruby é uma linguagem de programação dinâmica e de código aberto com foco na simplicidade e produtividade. Tem uma sintaxe elegante que é natural de ler e fácil de escrever. Antes de começar, certifique-se de ter privilégios de administrador no seu computador.

O que você aprenderá:

  • Instalar Ruby 3.x no seu sistema operacional
  • Configurar ferramentas de desenvolvimento
  • Verificar sua instalação
  • Escolher e configurar um editor de código
  • Executar seu primeiro código Ruby

Instalação no Windows

Método 1: RubyInstaller (Recomendado para Windows 11/10)

  1. Baixar RubyInstaller

    • Visite RubyInstaller Downloads
    • Baixe Ruby+Devkit 3.x.x-x64 (versão 3.x mais recente)
    • Escolha a versão com Devkit incluído

  2. Executar o Instalador

    • Clique duas vezes no arquivo .exe baixado
    • Aceite o contrato de licença
    • Importante: Marque "Adicionar executáveis Ruby ao seu PATH"
    • Marque "Associar arquivos .rb e .rbw com Ruby"
    • Clique em "Instalar"

  3. Instalar Toolchain MSYS2

    • Após a instalação do Ruby, a configuração do MSYS2 aparecerá
    • Escolha a opção 3 (instalar todos os componentes)
    • Aguarde a conclusão da instalação

  4. Verificar Instalação no Windows

    ruby -v
gem -v

Método 2: Windows Subsystem for Linux (WSL)

Para usuários avançados que preferem ambiente Linux no Windows:

  1. Ativar WSL

    wsl --install

  2. Instalar Ubuntu e seguir instruções do Linux abaixo

Instalação no macOS

Método 1: rbenv (Recomendado para macOS 13+)

  1. Instalar Homebrew (se ainda não estiver instalado)

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

  2. Instalar rbenv e ruby-build

    brew install rbenv ruby-build

  3. Configurar rbenv no seu shell

    echo 'eval "$(rbenv init -)"' >> ~/.zshrc
source ~/.zshrc

  4. Instalar Ruby 3.x

    rbenv install 3.3.0  # Use a versão 3.x mais recente
rbenv global 3.3.0

  5. Verificar instalação do rbenv

    rbenv versions
ruby -v

Método 2: asdf (Alternativa)

  1. Instalar asdf

    brew install asdf
echo -e "\n. $(brew --prefix asdf)/libexec/asdf.sh" >> ~/.zshrc
source ~/.zshrc

  2. Instalar plugin Ruby e Ruby

    asdf plugin add ruby
asdf install ruby latest
asdf global ruby latest

Método 3: RVM (Ruby Version Manager)

  1. Instalar RVM

    \curl -sSL https://get.rvm.io | bash -s stable
source ~/.rvm/scripts/rvm

  2. Instalar Ruby

    rvm install 3.3.0
rvm use 3.3.0 --default

Instalação no Linux

Ubuntu/Debian (22.04+)

  1. Atualizar gerenciador de pacotes

    sudo apt update
sudo apt upgrade -y

  2. Instalar dependências

    sudo apt install -y git curl libssl-dev libreadline-dev zlib1g-dev \
autoconf bison build-essential libyaml-dev libreadline-dev libncurses5-dev \
libffi-dev libgdbm-dev libdb-dev

  3. Instalar rbenv (Recomendado)

    git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
source ~/.bashrc

  4. Instalar ruby-build

    git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build

  5. Instalar Ruby 3.x

    rbenv install 3.3.0
rbenv global 3.3.0

Fedora/RHEL (36+)

  1. Instalar dependências

    sudo dnf install -y git curl gcc bison libffi-devel libyaml-devel \
make autoconf automake libtool readline-devel openssl-devel

  2. Instalar rbenv e Ruby (siga os passos 3-5 da seção Ubuntu)

Arch Linux

  1. Instalar dos repositórios oficiais

    sudo pacman -S ruby

  2. Ou instalar rbenv do AUR

    yay -S rbenv ruby-build

Passos de Verificação

Após a instalação, verifique se tudo está funcionando:

  1. Verificar versão do Ruby

    ruby -v
# Deve mostrar: ruby 3.x.x

  2. Verificar gerenciador de gems

    gem -v

  3. Verificar bundler

    gem install bundler
bundle -v

  4. Criar um arquivo de teste

    # test.rb
puts "Olá, Ruby!"
puts "Versão do Ruby: #{RUBY_VERSION}"

  5. Executar o teste

    ruby test.rb

Editores de Código

Visual Studio Code (Recomendado)

  1. Baixar e instalar VS Code

  2. Instalar extensões Ruby

    • Ruby (por Peng Lv)
    • Ruby Solargraph (para autocompletar)
    • VSCode Ruby (por Stafford Brunk)

  3. Configurar VS Code

    • Abra Paleta de Comandos (Ctrl/Cmd + Shift + P)
    • Digite "Ruby: Configure"
    • Selecione sua versão Ruby

Sublime Text

  1. Baixar Sublime Text

  2. Instalar Package Control

  3. Instalar pacotes Ruby

    • RubyTest
    • SublimeLinter-ruby
    • Ruby Enhanced

Ruby Interativo (IRB)

IRB é o shell interativo do Ruby. Tente estes comandos:

  1. Iniciar IRB

    irb

  2. Expressões básicas Ruby

    puts "Olá, Mundo!"
2 + 2
"Ruby é incrível!".upcase

  3. Sair do IRB

    exit

Solução de Problemas

Problemas Comuns

1. "ruby: command not found"

  • Certifique-se de que Ruby está no seu PATH
  • Reinicie seu terminal/prompt de comando
  • Verifique os passos de instalação novamente

2. Erros de "Permissão negada"

  • Não use sudo gem install
  • Use rbenv/rvm para gerenciar versões Ruby
  • Verifique permissões de arquivo

3. Windows: "Instalação MSYS2 falhou"

  • Instale Visual Studio Build Tools
  • Execute instalador como Administrador
  • Desative antivírus temporariamente

4. macOS: "Ferramentas de Linha de Comando Xcode necessárias"

xcode-select --install

5. Erros de certificado SSL

# Atualizar certificados
gem update --system

Obtendo Ajuda

  • Documentação Ruby: ruby-doc.org
  • Comunidade Ruby: ruby-lang.org
  • Stack Overflow: Marque suas perguntas com "ruby"
  • Reddit: r/ruby

Próximos Passos

Parabéns! Agora você tem Ruby instalado. Aqui está o que fazer em seguida:

  1. Aprenda o básico de Ruby com Ruby em Vinte Minutos
  2. Experimente Ruby online em Try Ruby
  3. Construa seu primeiro projeto - talvez uma calculadora simples ou lista de tarefas
  4. Junte-se à comunidade e comece a contribuir para código aberto

Lembre-se: Programar é uma jornada, não um destino. Tire seu tempo, pratique regularmente e não hesite em pedir ajuda. Bem-vindo ao maravilhoso mundo da programação Ruby! 🎉

Este guia é mantido pela comunidade Ruby. Última atualização: Março 2026