M 系列芯片 Mac 现代开发环境配置全指南

这是一份专为 Apple Silicon (M1/M2/M3) 芯片量身定制的开发环境指南。它不仅涵盖了基础工具的安装，更重点解决了开发环境下 GitHub 访问不畅、原生构建脚本被拦截等痛点。

第一阶段：基础开发环境搭建

在 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，是目前 macOS 上性能最优的 Node 管理器。

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

第二阶段：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

第三阶段：标准化开发工作流

环境就绪后，遵循一套标准化的操作流程能极大提升协作与维护的效率。

1. 环境对齐 (Environment Check)

进入项目目录后，验证环境是否正确对齐：

node -v && pnpm -v

2. 依赖管理

由于已开启脚本执行权限，执行安装时原生模块会自动完成本地编译：

pnpm install

3. 规范化提交 (Commit)

推荐使用 Conventional Commits 规范，保持提交历史清晰：

• feat: 新功能
• fix: 修复 Bug
• chore: 构建过程或辅助工具的变动
• docs: 文档变更

技巧： 可以利用 AI 工具辅助生成地道的提交信息：

git diff --cached | <ai_tool_command> "根据改动生成英文提交信息"

4. 推送与同步

git pull origin main  # 推送前先拉取，避免冲突
git push origin main

发布于: 2026年2月12日 · 修改于: 2026年2月12日

RR

创业