Полное руководство по настройке современной среды разработки на Mac с чипом M

Это исчерпывающее руководство, специально разработанное для чипов Apple Silicon (M1/M2/M3). Оно охватывает не только установку основных инструментов, но и решает болевые точки, такие как проблемы подключения к GitHub и блокировка нативных скриптов сборки в средах разработки.

Фаза 1: Настройка основной среды разработки

На чипах серии M выравнивание путей и архитектур имеет решающее значение для стабильности.

1. Установка Homebrew (менеджер пакетов)

На Apple Silicon Homebrew устанавливается в /opt/homebrew по умолчанию.

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

Настройка переменных окружения:

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

2. Установка fnm (менеджер версий Node.js)

fnm нативно поддерживает ARM64 и в настоящее время является наиболее производительным менеджером Node для macOS.

brew install fnm

Добавьте следующее в ~/.zshrc для автоматического переключения версий Node при входе в директории проектов:

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

3. Установка pnpm (основной менеджер пакетов)

Рекомендуется устанавливать отдельно через Homebrew с оптимизированной глобальной конфигурацией:

brew install pnpm
pnpm setup
source ~/.zshrc

Ключевая оптимизация: Разрешить автоматическое выполнение скриптов сборки нативных модулей (таких как Gemini CLI, Sharp и т.д.) для предотвращения ошибок компиляции на чипах M:

pnpm config set -g ignore-scripts false

Фаза 2: Безопасное подключение к GitHub и сетевое туннелирование

Решение распространенных проблем с таймаутом или сбросом соединения через SSH-over-HTTPS (порт 443) с использованием прокси-инструментов.

1. Глобальная конфигурация идентичности

Замените заполнители ниже своей информацией GitHub:

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

2. Генерация ключа ED25519

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

Выполните cat ~/.ssh/id_ed25519.pub и добавьте содержимое в GitHub SSH Settings.

3. Создание «универсального» файла конфигурации SSH

Отредактируйте ~/.ssh/config, чтобы обеспечить прохождение трафика через назначенный прокси-порт (в примере используется 7897):

Host github.com
  HostName ssh.github.com
  Port 443
  User git
  IdentityFile ~/.ssh/id_ed25519
  AddKeysToAgent yes
  UseKeychain yes
  # Принудительно через локальный прокси (измените порт в соответствии с вашим прокси-инструментом)
  ProxyCommand nc -X 5 -x 127.0.0.1:7897 %h %p

Исправление разрешений:

chmod 600 ~/.ssh/config

Фаза 3: Стандартизированный рабочий процесс разработки

Когда среда готова, следование стандартизированному рабочему процессу значительно повышает эффективность сотрудничества и обслуживания.

1. Проверка среды

После входа в директорию проекта проверьте, правильно ли выровнена среда:

node -v && pnpm -v

2. Управление зависимостями

При включенном выполнении скриптов нативные модули автоматически завершают локальную компиляцию во время установки:

pnpm install

3. Соглашения о коммитах

Рекомендуем использовать спецификацию Conventional Commits для поддержания четкой истории коммитов:

• feat: Новая функция
• fix: Исправление ошибки
• chore: Изменения в процессе сборки или вспомогательных инструментах
• docs: Изменения документации

Подсказка: Вы можете использовать инструменты ИИ для помощи в создании соответствующих сообщений о коммитах:

git diff --cached | <ai_tool_command> "Сгенерировать сообщение о коммите на английском на основе изменений"

4. Push и синхронизация

git pull origin main  # Pull перед push для предотвращения конфликтов
git push origin main

Опубликовано: 12 февр. 2026 г. · Изменено: 12 февр. 2026 г.

RR

Build