Ruby do Zero: Ambiente, Instalação e Primeiro Código Executável

O que você precisa para executar Ruby

Para rodar código Ruby no seu computador, você precisa de três elementos: (1) o interpretador Ruby instalado (o programa ruby), (2) um terminal (Prompt/PowerShell no Windows, Terminal no macOS/Linux) e (3) um editor de texto para criar arquivos .rb. Com isso, você consegue validar o ambiente executando comandos como ruby -v e rodando um script com ruby arquivo.rb.

Instalação do Ruby (Windows, macOS, Linux)

Windows (RubyInstaller)

No Windows, a forma mais direta é usar o RubyInstaller, que já prepara o Ruby e integra com o sistema.

• Baixe e instale uma versão estável do Ruby para Windows (x64).
• Durante a instalação, marque a opção para adicionar o Ruby ao PATH (se disponível).
• Ao final, pode aparecer um assistente para instalar componentes do MSYS2 (necessário para compilar algumas gems). Se aparecer, aceite e conclua.

Depois, abra um terminal novo (PowerShell ou Prompt) para garantir que as variáveis de ambiente foram recarregadas.

macOS

No macOS, é comum instalar Ruby via gerenciador de versões (recomendado) ou via gerenciador de pacotes. O objetivo é ter um ruby atual e controlável.

• Instale um gerenciador de versões de Ruby (por exemplo, rbenv ou asdf) e então instale uma versão do Ruby por ele.
• Alternativamente, use um gerenciador de pacotes (como Homebrew) para instalar Ruby.

Se você usar um gerenciador de versões, ele normalmente configura o caminho do Ruby no shell. Ainda assim, a validação final é sempre via terminal com ruby -v.

Continue em nosso aplicativo e ...

• Ouça o áudio com a tela desligada
• Ganhe Certificado após a conclusão
• + de 5000 cursos para você explorar!

ou continue lendo abaixo...

Baixar o aplicativo

Linux (Ubuntu/Debian, Fedora, Arch e similares)

No Linux, você pode instalar Ruby pelos repositórios da distribuição ou por um gerenciador de versões. Para desenvolvimento, gerenciador de versões costuma ser a opção mais flexível.

• Opção 1: instalar via gerenciador de pacotes da distro (rápido, pode ser versão mais antiga).
• Opção 2: instalar via gerenciador de versões (controle de versões por projeto, geralmente mais atual).

Independentemente do método, o ponto-chave é: o comando ruby precisa estar acessível no terminal.

Verificando a instalação no terminal

Após instalar, valide se o Ruby está disponível e qual versão está ativa.

Checar versão do Ruby

ruby -v

Exemplo de saída (varia conforme sua versão):

ruby 3.3.0 (2023-12-25 revision ...) [x86_64-linux]

Checar onde o Ruby está instalado (útil para diagnosticar PATH)

No macOS/Linux:

which ruby

No Windows (PowerShell):

where.exe ruby

Se esses comandos não retornarem um caminho, o terminal não está encontrando o Ruby (problema típico de PATH).

Quando (e como) ajustar variáveis de ambiente (PATH)

O PATH é uma lista de pastas que o sistema consulta para encontrar executáveis. Se o Ruby foi instalado, mas ruby -v não funciona, geralmente é porque a pasta do Ruby não está no PATH ou há conflito com outra instalação.

Diagnóstico rápido

• Sintoma: ruby não é reconhecido como comando.
• Causa provável: Ruby não está no PATH (ou terminal antigo não recarregou).
• Ação: feche e reabra o terminal; se persistir, ajuste o PATH.

Ajustando PATH no Windows

Passo a passo (interface gráfica):

• Abra Configurações > Sistema > Sobre > Configurações avançadas do sistema.
• Clique em Variáveis de Ambiente.
• Em Variáveis do sistema (ou do usuário), selecione Path > Editar.
• Adicione o caminho da pasta bin do Ruby (ex.: algo como C:\Ruby33-x64\bin, dependendo da instalação).
• Confirme, feche e reabra o terminal.

Dica: se você instalou via RubyInstaller e marcou “Add to PATH”, normalmente isso já vem pronto. Ajuste manual só se necessário.

Ajustando PATH no macOS/Linux (shell)

Se você instalou Ruby em um local que não está no PATH, pode ser necessário editar o arquivo de configuração do seu shell.

• Para zsh (comum no macOS): edite ~/.zshrc.
• Para bash: edite ~/.bashrc ou ~/.bash_profile.

Exemplo genérico de adição de um diretório ao PATH:

export PATH="$HOME/.local/bin:$PATH"

Depois de salvar, recarregue:

source ~/.zshrc

Observação: se você usa gerenciador de versões (rbenv/asdf), ele normalmente exige que uma linha de inicialização esteja no arquivo do shell. Siga as instruções do instalador do gerenciador e valide com ruby -v.

Criando e executando seu primeiro arquivo .rb

Com o Ruby instalado e validado, o próximo passo é criar um arquivo Ruby e executá-lo pelo terminal. Isso confirma que seu ambiente está funcional de ponta a ponta: editor → arquivo → terminal → interpretador.

Passo a passo: criar um projeto simples

1. Crie uma pasta para seus estudos/projetos, por exemplo: ruby-projetos.
2. Dentro dela, crie uma pasta para este primeiro teste, por exemplo: primeiro_script.
3. Crie um arquivo chamado hello.rb.
4. Escreva um código simples e salve.

Conteúdo sugerido para hello.rb:

puts "Ruby está funcionando!"

Executando no terminal

Navegue até a pasta do arquivo e execute:

ruby hello.rb

Se tudo estiver correto, você verá a frase impressa no terminal.

Erros comuns ao executar um .rb

Executando Ruby de forma interativa com IRB

Além de rodar arquivos .rb, você pode experimentar Ruby em modo interativo com o irb (Interactive Ruby). É útil para testar expressões rapidamente, validar comportamento de métodos e fazer pequenas contas sem criar arquivo.

Iniciando o IRB

irb

Você verá um prompt onde pode digitar Ruby e pressionar Enter.

Exemplos rápidos no IRB

2 + 3

nome = "Ana"

"Olá, #{nome}!"

Para sair do IRB:

exit

ou pressione Ctrl + D (macOS/Linux) / Ctrl + Z e Enter (Windows, dependendo do terminal).

Organização inicial de pastas e convenções de nomes

Mesmo em scripts simples, uma organização mínima ajuda a evitar confusão e facilita evoluir para projetos maiores.

Estrutura sugerida para estudos e scripts

ruby-projetos/  primeiro_script/    hello.rb  calculadora/    main.rb    lib/      operacoes.rb

Convenções práticas de nomes

• Use nomes de arquivos em snake_case: meu_script.rb, calcula_imc.rb.
• Evite espaços e acentos em nomes de pastas/arquivos: prefira primeiro_script em vez de primeiro script.
• Mantenha um arquivo de entrada claro quando fizer algo maior: main.rb ou app.rb.
• Separe código auxiliar em uma pasta lib/ quando começar a ter mais de um arquivo.

Executando scripts em subpastas

Se seu arquivo principal estiver em uma pasta, execute a partir dela:

cd calculadora ruby main.rb

Ou informe o caminho:

ruby calculadora/main.rb