Guía Completa de Configuración de Entorno de Desarrollo Moderno para Mac con Chip M

Esta es una guía integral diseñada específicamente para chips Apple Silicon (M1/M2/M3). Cubre no solo la instalación de herramientas esenciales, sino que también aborda puntos problemáticos como problemas de conectividad con GitHub y el bloqueo de scripts de compilación nativos en entornos de desarrollo.

Fase 1: Configuración del Entorno de Desarrollo Esencial

En los chips de serie M, alinear rutas y arquitecturas es crucial para la estabilidad.

1. Instalar Homebrew (Administrador de Paquetes)

En Apple Silicon, Homebrew se instala en /opt/homebrew por defecto.

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

Configurar Variables de Entorno:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

2. Instalar fnm (Administrador de Versiones de Node.js)

fnm es compatible nativamente con ARM64 y actualmente es el administrador de Node más eficiente para macOS.

brew install fnm

Agregue lo siguiente a ~/.zshrc para cambiar automáticamente las versiones de Node al entrar en directorios de proyecto:

echo 'eval "$(fnm env --use-on-cd --shell zsh)"' >> ~/.zshrc
source ~/.zshrc

3. Instalar pnpm (Administrador de Paquetes Principal)

Se recomienda instalar por separado a través de Homebrew con configuración global optimizada:

brew install pnpm
pnpm setup
source ~/.zshrc

Optimización Clave: Permitir la ejecución automática de scripts de compilación de módulos nativos (como Gemini CLI, Sharp, etc.) para evitar errores de compilación en chips M:

pnpm config set -g ignore-scripts false

Fase 2: Conexión Segura con GitHub y Túnel de Red

Resuelva problemas comunes de tiempo de espera de conexión o restablecimiento a través de SSH-over-HTTPS (puerto 443) con herramientas proxy.

1. Configuración de Identidad Global

Reemplace los marcadores de posición a continuación con su información de GitHub:

git config --global user.name "<your_username>"
git config --global user.email "<your_email@example.com>"
git config --global init.defaultBranch main

2. Generar Clave ED25519

ssh-keygen -t ed25519 -C "<your_email@example.com>"

Ejecute cat ~/.ssh/id_ed25519.pub y agregue el contenido a GitHub SSH Settings.

3. Escribir un Archivo de Configuración SSH “Universal”

Edite ~/.ssh/config para asegurar que el tráfico pase a través de su puerto proxy designado (el ejemplo usa 7897):

Host github.com
  HostName ssh.github.com
  Port 443
  User git
  IdentityFile ~/.ssh/id_ed25519
  AddKeysToAgent yes
  UseKeychain yes
  # Forzar a través de proxy local (modificar puerto según su herramienta proxy)
  ProxyCommand nc -X 5 -x 127.0.0.1:7897 %h %p

Corrección de Permisos:

chmod 600 ~/.ssh/config

Fase 3: Flujo de Trabajo de Desarrollo Estandarizado

Una vez que el entorno está listo, seguir un flujo de trabajo estandarizado mejora enormemente la eficiencia de colaboración y mantenimiento.

1. Verificación del Entorno

Después de entrar en un directorio de proyecto, verifique que el entorno esté correctamente alineado:

node -v && pnpm -v

2. Gestión de Dependencias

Con la ejecución de scripts habilitada, los módulos nativos completarán automáticamente la compilación local durante la instalación:

pnpm install

3. Commits Convencionales

Recomendamos usar la especificación Conventional Commits para mantener el historial de commits claro:

• feat: Nueva característica
• fix: Corrección de error
• chore: Cambios en el proceso de compilación o herramientas auxiliares
• docs: Cambios en documentación

Consejo: Puede usar herramientas de IA para ayudar a generar mensajes de commit adecuados:

git diff --cached | <ai_tool_command> "Generar mensaje de commit en inglés basado en cambios"

4. Push y Sync

git pull origin main  # Hacer pull antes de push para evitar conflictos
git push origin main

Publicado el: 12 de feb de 2026 · Modificado el: 12 de feb de 2026

RR

Build