Guia de Configuração de Ambiente

Visão Geral

Ajude os desenvolvedores a configurar ambientes de desenvolvimento completos do zero. Esta habilidade fornece orientação passo a passo para instalar ferramentas, configurar dependências, definir variáveis de ambiente e verificar se a configuração funciona corretamente.

Quando Usar Esta Habilidade

• Use ao iniciar um novo projeto e precisar configurar o ambiente de desenvolvimento
• Use ao integrar novos membros à equipe em um projeto
• Use ao mudar para uma nova máquina ou sistema operacional
• Use ao solucionar problemas relacionados ao ambiente
• Use ao documentar instruções de configuração para um projeto
• Use ao criar documentação de ambiente de desenvolvimento

Como Funciona

Passo 1: Identificar Requisitos

Ajudarei você a determinar o que precisa ser instalado:

• Linguagem de programação e versão (Node.js, Python, Go, etc.)
• Gerenciadores de pacotes (npm, pip, cargo, etc.)
• Sistemas de banco de dados (PostgreSQL, MongoDB, Redis, etc.)
• Ferramentas de desenvolvimento (Git, Docker, extensões de IDE, etc.)
• Variáveis de ambiente e arquivos de configuração

Passo 2: Verificar Configuração Atual

Antes de instalar qualquer coisa, ajudarei você a verificar o que já está instalado:

# Check versions of installed tools
node --version
python --version
git --version
docker --version

Passo 3: Fornecer Instruções de Instalação

Fornecerei comandos de instalação específicos para cada plataforma:

• macOS: Usando Homebrew
• Linux: Usando apt, yum ou gerenciador de pacotes
• Windows: Usando Chocolatey, Scoop ou instaladores diretos

Passo 4: Configurar o Ambiente

Ajudar a configurar:

• Variáveis de ambiente (arquivos .env)
• Arquivos de configuração (.gitconfig, .npmrc, etc.)
• Configurações de IDE (VS Code, IntelliJ, etc.)
• Configuração do shell (.bashrc, .zshrc, etc.)

Passo 5: Verificar Instalação

Fornecer etapas de verificação para garantir que tudo funcione:

• Executar verificações de versão
• Testar comandos básicos
• Verificar conexões de banco de dados
• Verificar se as variáveis de ambiente foram carregadas

Exemplos

Exemplo 1: Configuração de Projeto Node.js

## Setting Up Node.js Development Environment

### Prerequisites
- macOS, Linux, or Windows
- Terminal/Command Prompt access
- Internet connection

### Step 1: Install Node.js

**macOS (using Homebrew):**
\`\`\`bash
# Install Homebrew if not installed
tmpdir="$(mktemp -d)"
trap 'rm -rf "$tmpdir"' EXIT
curl -fsSLo "$tmpdir/homebrew-install.sh" https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh
cat "$tmpdir/homebrew-install.sh"  # review the full installer before executing
/bin/bash "$tmpdir/homebrew-install.sh"

# Install Node.js
brew install node
\`\`\`

**Linux (Ubuntu/Debian):**
\`\`\`bash
# Update package list
sudo apt update

# Install Node.js and npm
tmpdir="$(mktemp -d)"
trap 'rm -rf "$tmpdir"' EXIT
curl -fsSLo "$tmpdir/nodesource-setup.sh" https://deb.nodesource.com/setup_20.x
cat "$tmpdir/nodesource-setup.sh"  # review the full installer before sudo
sudo -E bash "$tmpdir/nodesource-setup.sh"
sudo apt install -y nodejs
\`\`\`

**Windows (using winget):**
\`\`\`powershell
# Install Node.js
winget install OpenJS.NodeJS.LTS
\`\`\`

### Step 2: Verify Installation

\`\`\`bash
node --version  # Should show v20.x.x or higher
npm --version   # Should show 10.x.x or higher
\`\`\`

### Step 3: Install Project Dependencies

\`\`\`bash
# Clone the repository
git clone https://github.com/your-repo/project.git
cd project

# Install dependencies
npm install
\`\`\`

### Step 4: Set Up Environment Variables

Create a \`.env\` file:
\`\`\`bash
# Copy example environment file
cp .env.example .env

# Edit with your values
nano .env
\`\`\`

Example \`.env\` content:
\`\`\`
NODE_ENV=development
PORT=3000
DATABASE_URL=postgresql://localhost:5432/mydb
API_KEY=your-api-key-here
\`\`\`

### Step 5: Run the Project

\`\`\`bash
# Start development server
npm run dev

# Should see: Server running on http://localhost:3000
\`\`\`

### Troubleshooting

**Problem:** "node: command not found"
**Solution:** Restart your terminal or run \`source ~/.bashrc\` (Linux) or \`source ~/.zshrc\` (macOS)

**Problem:** "Permission denied" errors
**Solution:** Don't use sudo with npm. Fix permissions:
\`\`\`bash
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
\`\`\`

Exemplo 2: Configuração de Projeto Python

## Configurando Ambiente de Desenvolvimento Python

### Passo 1: Instalar Python

**macOS:**
\`\`\`bash
brew install python@3.11
\`\`\`

**Linux:**
\`\`\`bash
sudo apt update

…