macOS开发环境迁移：跨设备配置同步的常见障碍与高效解决方法

macOS开发环境迁移这件事，在每一个从新机器开始开发的程序员眼里都是一件麻烦事。明明老电脑上的环境早就配置得顺风顺水，换到新设备后却发现什么都跑不起来——编译器找不到、包管理器没装、环境变量丢了、SSH连不上远程服务器。这些问题的根源在于，macOS系统本身并不提供开箱即用的开发环境同步机制，而开发者个人配置的积累往往散落在各个角落，缺乏统一的迁移方案。

一、应用场景分析

1.1 典型迁移场景

当你从一台旧Mac升级到新款Mac时，或者团队中多位开发者需要共享同一套标准化开发环境时，环境迁移就成为一个高频需求。比如，你刚换了一台全新的MacBook Pro，上面的开发环境几乎是白板状态——没有Homebrew，没有Node.js，没有Python的虚拟环境，没有Docker，没有Git配置，没有SSH密钥。而老电脑上这些东西全都有，手动一个个配置可能要花上一整天。

1.2 目标读者画像

本文面向的读者包括：刚换设备想要快速恢复开发状态的独立开发者、需要为新入职同事准备标准化环境的团队Tech Lead、以及希望在多台设备间保持开发环境一致的全栈工程师。无论你是刚入门的初学者还是有多年经验的资深开发者，只要能看懂终端操作，就能从本文中受益。

1.3 技术栈说明

本文所有示例统一使用 Shell Scripting (Bash/Zsh) 作为技术栈，配合Homebrew包管理器完成环境搭建与配置同步。之所以选择Shell脚本，是因为它是macOS终端的母语，几乎所有系统级的配置操作都可以通过命令行完成，而且脚本具有极强的可复用性和自动化能力。

二、常见迁移障碍深度剖析

2.1 环境变量与Shell配置丢失

macOS从版本10.15 Catalina开始，默认Shell从Bash切换到了Zsh。这意味着你之前在Bash中配置的所有环境变量、别名、函数，在新环境中可能全部失效。更麻烦的是，系统默认会创建新的.zshrc和.zprofile文件，而你的旧配置散落在.bashrc和.bash_profile中。

举一个典型的失败案例：你在新电脑上打开终端，输入node命令发现提示command not found。排查后发现Node.js其实装了，只是nvm的配置路径没有在新Shell中加载。

#!/bin/zsh
# 技术栈: Shell Scripting (Zsh)
# 问题: 新设备默认使用Zsh，旧的Bash配置无法自动迁移
# 
# 检查当前Shell版本
echo "当前Shell: $SHELL"
echo "Shell路径: $(which $SHELL)"

# 检查是否存在旧配置文件
if [ -f ~/.bash_profile ]; then
    echo "检测到旧版Bash配置文件: ~/.bash_profile"
    echo "其中的环境变量在新Zsh环境中不会自动加载"
fi

# 修复: 将关键环境变量手动写入新配置文件
# 注意: Zsh配置文件加载顺序为 .zshenv -> .zprofile -> .zshrc
echo '' >> ~/.zshrc
echo '# 从旧Bash环境迁移的环境变量' >> ~/.zshrc
echo 'export PATH="$HOME/.nvm/versions/node/v18.16.0/bin:$PATH"' >> ~/.zshrc
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
source ~/.zshrc  # 立即生效，无需重启终端

2.2 Homebrew包管理器的路径差异

Apple Silicon芯片（M1/M2/M3）的Mac上，Homebrew的安装路径与Intel芯片Mac完全不同。Intel Mac的Homebrew安装在/usr/local下，而Apple Silicon Mac安装在/opt/homebrew下。如果你在新机器上直接复制旧机器上的PATH配置，会导致命令找不到。

#!/bin/bash
# 技术栈: Shell Scripting (Bash)
# 场景: 自动检测芯片类型并配置正确的Homebrew路径

# 检测CPU架构
ARCH=$(uname -m)
echo "检测到的CPU架构: $ARCH"

if [ "$ARCH" = "arm64" ]; then
    # Apple Silicon芯片的Homebrew路径
    BREW_PREFIX="/opt/homebrew"
    echo "Apple Silicon架构，使用路径: $BREW_PREFIX"
    
    # 配置zsh的环境变量
    echo '' >> ~/.zprofile
    echo '# Apple Silicon Homebrew路径配置' >> ~/.zprofile
    echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
    
elif [ "$ARCH" = "x86_64" ]; then
    # Intel芯片的Homebrew路径
    BREW_PREFIX="/usr/local"
    echo "Intel架构，使用路径: $BREW_PREFIX"
    
    echo '' >> ~/.bash_profile
    echo '# Intel Homebrew路径配置' >> ~/.bash_profile
    echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.bash_profile
fi

# 验证配置是否生效
echo "验证: Homebrew版本检查..."
brew --version
echo "验证: Homebrew路径检查..."
echo $BREW_PREFIX

2.3 Xcode工具链与SDK版本不一致

Xcode是macOS开发者最核心的工具之一，但它体积庞大（动辄15GB以上），而且不同版本的SDK可能与你项目的依赖库不兼容。更棘手的是，Xcode Command Line Tools是独立于Xcode本体安装的，迁移时经常遗漏。

#!/bin/bash
# 技术栈: Shell Scripting (Bash)
# 场景: 迁移后Xcode环境检查与Command Line Tools安装

# 第一步: 检查Xcode是否已安装
if xcode-select -p &>/dev/null; then
    echo "Xcode已安装，路径: $(xcode-select -p)"
else
    echo "Xcode未安装或未配置，尝试安装Command Line Tools..."
fi

# 第二步: 安装Command Line Tools（即使已有Xcode也需要）
xcode-select --install

# 第三步: 安装完成后，配置Xcode路径（如果安装了完整Xcode）
# 注意: 这一步可能需要GUI确认，无法完全自动化
xcode-select -p  # 查看当前指向的Xcode路径

# 第四步: 接受Xcode许可协议（必须步骤，否则CLI命令会失败）
sudo xcodebuild -license accept

# 第五步: 安装SDK
xcodebuild -downloadAllSDKs

# 第六步: 验证所有工具链可用
echo "--- 工具链验证 ---"
echo "gcc: $(gcc --version | head -1)"
echo "clang: $(clang --version | head -1)"
echo "swift: $(swift --version 2>/dev/null | head -1)"
echo "sdk路径: $(xcrun --show-sdk-path)"
echo "sdk版本: $(xcrun --show-sdk-version)"

2.4 SSH密钥与凭证管理器

SSH密钥是你连接GitHub、GitLab等代码托管平台的身份凭证。如果新设备没有这些密钥，你连git push都会失败。同时，macOS的Keychain（钥匙串）在换设备后不会自动同步，里面存着的数据库密码、Git凭据也会丢失。

#!/bin/bash
# 技术栈: Shell Scripting (Bash)
# 场景: SSH密钥迁移与Git全局配置恢复

# 方案A: 从旧设备生成密钥并迁移到新设备
# 这里演示在新设备上直接生成新密钥的步骤

# 检查是否已有SSH密钥
if [ -f ~/.ssh/id_rsa ]; then
    echo "检测到已有SSH密钥: ~/.ssh/id_rsa"
    ssh-keygen -lf ~/.ssh/id_rsa  # 查看密钥指纹
elif [ -f ~/.ssh/id_ed25519 ]; then
    echo "检测到Ed25519密钥: ~/.ssh/id_ed25519"
    ssh-keygen -lf ~/.ssh/id_ed25519
else
    echo "未发现SSH密钥，开始生成..."
    
    # 生成Ed25519密钥对（推荐，比RSA更安全）
    ssh-keygen -t ed25519 -C "your_email@example.com" -f ~/.ssh/id_ed25519
    echo "密钥生成完成"
fi

# 配置SSH已知主机
mkdir -p ~/.ssh
chmod 700 ~/.ssh

# 配置SSH客户端，自动使用密钥文件
cat > ~/.ssh/config << 'SSHCONFIG'
# GitHub配置
Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519
    AddKeysToAgent yes
    UseKeychain yes

# 公司Git服务器配置（按需修改）
Host company-git
    HostName git.company.com
    User git
    IdentityFile ~/.ssh/id_ed25519
SSHCONFIG

chmod 600 ~/.ssh/config

# 配置Git全局信息（新设备必做）
git config --global user.name "Your Name"
git config --global user.email "your_email@example.com"
git config --global core.editor "code --wait"  # 使用VS Code作为默认编辑器
git config --global pull.rebase true            # 拉取时使用rebase而非merge
git config --global core.autocrlf input          # 自动处理换行符
git config --global init.defaultBranch main      # 默认分支名为main

# 验证Git配置
echo "--- Git配置验证 ---"
git config --global --list  # 列出所有全局配置

2.5 第三方开发工具的配置差异

除了系统级的工具外，各种语言运行时（Node.js、Python、Java等）和IDE的设置也需要迁移。每个工具的配置方式不同，手动逐一恢复非常耗时。

#!/bin/bash
# 技术栈: Shell Scripting (Bash)
# 场景: 使用nvm管理Node.js版本迁移

# 安装nvm（Node版本管理器）
# 注意: macOS上推荐用brew安装nvm，但这里演示手动安装方式以便理解原理

# 方法1: 通过brew安装（推荐）
brew install nvm
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo 'export NVM_AUTO_USE=true' >> ~/.zshrc

# 方法2: 查看已安装的所有Node版本
nvm ls

# 安装与旧设备一致的Node版本
nvm install 18.16.0   # 安装指定版本
nvm use 18.16.0       # 切换到该版本
nvm alias default 18.16.0  # 设为默认版本

# 恢复npm全局包（需要提前保存列表）
# 先获取旧设备的全局包列表
# 在旧设备上执行: npm list -g --depth=0 > global-packages.txt
# 然后将global-packages.txt带到新设备上

# 安装全局包（从列表文件恢复）
# 注意: 这种方式比逐个安装更高效
npm install -g typescript node-sass prettier eslint --save-dev

# 恢复npm配置
npm config set registry https://registry.npmmirror.com  # 国内镜像加速
npm config set prefix $HOME/.npm-global                  # 避免权限问题
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc

# 验证
echo "Node版本: $(node -v)"
echo "npm版本: $(npm -v)"
echo "npm全局包列表:"
npm list -g --depth=0

三、高效解决方法详解

3.1 使用Dotfiles统一管理配置文件

Dotfiles（以.开头的隐藏配置文件）是Unix类系统中最重要的配置载体。将它们纳入Git管理，就能实现跨设备的配置同步。

#!/bin/bash
# 技术栈: Shell Scripting (Bash)
# 工具: Dotfiles管理方案
# 说明: 将所有配置文件集中在一个仓库中，通过脚本一键部署

# 创建Dotfiles仓库结构
DOTFILES_DIR="$HOME/.dotfiles"
mkdir -p "$DOTFILES_DIR"

# 创建核心配置文件模板

# --- .zshrc模板 ---
cat > "$DOTFILES_DIR/.zshrc" << 'ZSHRC'
# ============ Shell 环境配置 ============
# 自动加载Homebrew环境
if [ -f "/opt/homebrew/bin/brew" ]; then
    eval "$(/opt/homebrew/bin/brew shellenv)"
elif [ -f "/usr/local/bin/brew" ]; then
    eval "$(/usr/local/bin/brew shellenv)"
fi

# 加载nvm（Node版本管理）
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

# 加载pyenv（Python版本管理）
export PYENV_ROOT="$HOME/.pyenv"
[ -d "$PYENV_ROOT/bin" ] && export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)" 2>/dev/null

# 常用别名
alias ll='ls -lah'        # 长格式列表显示所有文件
alias gs='git status'     # 快速查看Git状态
alias gd='git diff'       # 快速查看差异
alias ..='cd ..'          # 返回上级目录
alias ...='cd ../..'      # 返回两级目录

# 快速导航函数
mkcd() {
    # 创建目录并立即进入
    mkdir -p "$1" && cd "$1"
}
ZSHRC

# 创建符号链接（让配置文件生效）
# 注意: 符号链接方式比复制更优雅，修改仓库文件即自动同步
ln -sf "$DOTFILES_DIR/.zshrc" ~/.zshrc
ln -sf "$DOTFILES_DIR/.bash_profile" ~/.bash_profile

echo "Dotfiles部署完成！重启终端生效"

3.2 自动化脚本迁移工具链

将上述所有步骤整合成一个可执行脚本，实现"一条命令搞定所有"的目标。

#!/bin/bash
# 技术栈: Shell Scripting (Bash)
# 功能: macOS开发环境一键迁移脚本
# 使用方法: chmod +x setup-dev-env.sh && ./setup-dev-env.sh

set -e  # 遇到错误立即退出
set -o pipefail  # 管道中任何命令失败都视为失败

echo "======================================"
echo "   macOS 开发环境自动迁移脚本 v1.0"
echo "======================================"
echo ""

# 颜色定义（让输出更清晰）
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m'  # 无颜色

# 记录开始时间
START_TIME=$(date +%s)

# 步骤1: 安装Homebrew（如果未安装）
echo -e "${YELLOW}[步骤 1/6] 检查Homebrew安装状态...${NC}"
if ! command -v brew &>/dev/null; then
    echo "Homebrew未安装，开始安装..."
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    echo -e "${GREEN}Homebrew安装完成${NC}"
else
    echo -e "${GREEN}Homebrew已安装，跳过${NC}"
fi

# 步骤2: 安装核心开发工具
echo -e "${YELLOW}[步骤 2/6] 安装核心开发工具...${NC}"
brew install git jq tree zsh completions coreutils &>/dev/null || true
brew install node python openssl &>/dev/null || true
echo -e "${GREEN}核心工具安装完成${NC}"

# 步骤3: 安装Xcode Command Line Tools
echo -e "${YELLOW}[步骤 3/6] 检查Xcode命令行工具...${NC}"
if ! xcode-select -p &>/dev/null; then
    xcode-select --install 2>/dev/null || echo "请手动安装Xcode CLI Tools"
fi
echo -e "${GREEN}Xcode工具检查完成${NC}"

# 步骤4: 配置Shell环境
echo -e "${YELLOW}[步骤 4/6] 配置Shell环境...${NC}"
source ~/.dotfiles/.zshrc 2>/dev/null || true
echo -e "${GREEN}Shell配置完成${NC}"

# 步骤5: 安装Docker（可选）
echo -e "${YELLOW}[步骤 5/6] Docker检查...${NC}"
if ! command -v docker &>/dev/null; then
    echo "提示: 请通过brew cask安装Docker Desktop"
    # brew install --cask docker
fi

# 步骤6: 显示环境摘要
echo -e "${YELLOW}[步骤 6/6] 生成环境摘要报告...${NC}"
END_TIME=$(date +%s)
DURATION=$((END_TIME - START_TIME))

cat << REPORT
======================================
   环境迁移完成报告
======================================
总耗时: ${DURATION}秒
Git:     $(git --version)
Node:    $(node -v 2>/dev/null || echo '未安装')
Python:  $(python3 --version 2>/dev/null || echo '未安装')
Docker:  $(docker --version 2>/dev/null || echo '未安装')
Brew:    $(brew --version | head -1)
======================================
请重启终端使所有配置生效
======================================
REPORT

3.3 Homebrew配方文件批量安装

Homebrew支持通过formula文件批量管理所有已安装的包。你可以把旧设备上的包列表导出来，到新设备上一键还原。

#!/bin/bash
# 技术栈: Shell Scripting (Bash)
# 功能: Homebrew包列表的导出与批量恢复

# === 在旧设备上执行：导出 ===
echo "导出旧设备上的Homebrew包列表..."
brew leaves > old-brew-packages.txt          # 只列出非依赖包
brew list --formula > old-brew-all.txt       # 列出所有包（含依赖）
brew bundle dump                              # 生成Brewfile（推荐方式）
echo "导出完成，将Brewfile带到新设备"

# === 在新设备上执行：恢复 ===
echo "从Brewfile恢复包列表..."

# 方法1: 使用brew bundle命令（最推荐）
# 假设Brewfile已在当前目录
if [ -f "Brewfile" ]; then
    brew bundle install --verbose
    echo "包安装完成"
fi

# 方法2: 手动从列表文件恢复（如果Brewfile不可用）
# 解析列表文件并逐个安装
# 注意: 需要去除文件中的注释行和空行
cat old-brew-packages.txt | grep -v '^#' | grep -v '^$' | xargs brew install

# 方法3: 安装tap源（第三方公式仓库）
brew tap homebrew/cask  # Cask用于GUI应用
brew tap homebrew/bundle  # bundle命令需要这个tap

# 安装常用GUI应用（通过Cask）
brew install --cask visual-studio-code docker docker-credential-osxkeychain
brew install --cask iterm2  # 推荐替代系统自带终端

# 验证安装结果
echo "--- Homebrew已安装包列表 ---"
brew list --formula | wc -l | xargs -I{} echo "总计安装 {} 个包"
brew outdated  # 检查哪些包有更新可用

3.4 Xcode环境一键配置

Xcode相关的环境配置比较特殊，因为很多步骤需要GUI操作，无法完全脚本化。但我们可以把能自动化的部分做到极致。

#!/bin/bash
# 技术栈: Shell Scripting (Bash)
# 功能: Xcode完整环境配置脚本

# 配置1: 设置Xcode开发目录
# 如果安装了完整Xcode
if [ -d "/Applications/Xcode.app" ]; then
    sudo xcode-select -s "/Applications/Xcode.app/Contents/Developer"
    echo "Xcode开发目录已指向完整应用"
else
    sudo xcode-select -s "/Library/Developer/CommandLineTools"
    echo "Xcode开发目录已指向CLI Tools"
fi

# 配置2: 接受许可协议（自动化处理）
sudo xcodebuild -license accept

# 配置3: 安装全部SDK
xcodebuild -downloadAllSDKs

# 配置4: 创建模拟器（需要GUI环境，此处仅做检查）
echo "--- 已安装的模拟器列表 ---"
xcrun simctl list devices available

# 配置5: 设置模拟器为默认启动目标
# 注意: 这一步通常需要在Xcode偏好设置中完成
echo "提示: 请在Xcode > Preferences > Devices中设置默认模拟器"

# 配置6: 设置Xcode的自动更新（可选）
defaults write com.apple.dt.Xcode IDESkipFirstLaunchWelcome YES
defaults write com.apple.dt.Xcode IDEDisableAutomaticSourceUpdates -bool YES

# 配置7: 检查Carthage（Swift依赖管理工具）
if ! command -v carthage &>/dev/null; then
    echo "安装Carthage（Swift依赖管理）..."
    brew install carthage
fi

# 配置8: 设置Sourcery（代码生成工具）
brew install sourcery

# 最终验证
echo ""
echo "===== Xcode环境验证 ====="
echo "Xcode路径: $(xcode-select -p)"
echo "SDK版本: $(xcrun --show-sdk-version)"
echo "可用模拟器: $(xcrun simctl list devices available | grep -c 'iPhone') 个iPhone模拟器"
echo "Carthage: $(carthage version 2>/dev/null || echo '未安装')"
echo "=========================="

3.5 跨设备同步策略

如果你有多台Mac设备（比如MacBook和iMac），保持它们之间的开发环境同步是一个持续需求。以下几种策略可以根据你的具体情况选择。

#!/bin/bash
# 技术栈: Shell Scripting (Bash)
# 功能: 多设备开发环境同步方案

# === 策略1: Git仓库同步Dotfiles ===
# 这是最推荐的方式，原理简单且可靠

# 初始化dotfiles仓库
cd ~/.dotfiles

# 创建.gitignore（某些文件不应同步）
cat > .gitignore << 'EOF'
# 不需要同步的文件
.env
*.env.local
node_modules/
.DS_Store
# SSH密钥绝对不要上传！
*.pem
*.key
id_rsa
id_ed25519
EOF

# 检查是否有未提交的变更
if [ -n "$(git status --porcelain)" ]; then
    git add .
    git commit -m "同步开发环境配置: $(date '+%Y-%m-%d %H:%M')"
    git push origin main
    echo "配置已推送到远程仓库"
else
    echo "配置已是最新，无需同步"
fi

# === 策略2: 在新设备上拉取最新配置 ===
echo ""
echo "在新设备上执行以下操作:"
echo "git clone git@github.com:yourname/dotfiles.git ~/.dotfiles"
echo "cd ~/.dotfiles && ./install.sh  # 运行安装脚本"

# === 策略3: 定期环境健康检查 ===
check_env_health() {
    echo ""
    echo "===== 环境健康检查报告 ====="
    
    # 检查关键工具是否可用
    for tool in "git" "node" "npm" "python3" "brew" "xcodebuild"; do
        if command -v "$tool" &>/dev/null; then
            printf "  ✓ %-12s %s\n" "$tool" "$($tool --version 2>/dev/null | head -1)"
        else
            printf "  ✗ %-12s 未安装\n" "$tool"
        fi
    done
    
    # 检查Homebrew是否有待更新
    local outdated_count
    outdated_count=$(brew outdated --formula 2>/dev/null | wc -l)
    echo "  待更新Homebrew包: $outdated_count 个"
    
    # 检查磁盘空间（开发环境通常需要较大空间）
    local free_space
    free_space=$(df -h / | awk 'NR==2{print $4}')
    echo "  可用磁盘空间: $free_space"
    
    echo "=============================="
}

check_env_health

四、技术优缺点对比

4.1 Shell脚本方案

优点： 零依赖，macOS终端原生支持，不需要额外安装什么工具就能运行。学习曲线平缓，即使是不熟悉脚本的新手也能看懂大部分内容。自动化程度高，一次编写后可以在任何新设备上重复使用。与Git配合使用，版本可控、变更可追溯。

缺点： Shell语法在不同版本间存在差异，Bash脚本在Zsh中可能需要调整。错误处理机制不如高级语言完善，脚本执行出错时调试比较费劲。无法处理需要GUI交互的操作，比如Xcode的安装确认对话框。脚本本身的安全性和权限管理需要特别注意。

4.2 Homebrew包管理方案

优点： Homebrew是macOS生态中最流行的包管理器，社区资源极其丰富。支持Brewfile文件描述完整环境，可读性好。安装和卸载命令简单直观，新手友好。自动处理包之间的依赖关系。

缺点： 只适用于macOS系统，跨平台能力为零。部分软件的安装路径在不同芯片架构下不一致。更新包时偶尔遇到编译错误，需要手动修复。大量安装时速度可能较慢。

4.3 Dotfiles版本控制方案

优点： 所有配置文件集中管理，迁移和备份极其方便。利用Git的历史版本功能，配置变更有迹可循。团队协作时可以直接共享标准化配置。可以结合Git hooks实现自动同步。

缺点： 需要维护一个额外的Git仓库，增加了管理成本。某些敏感信息（如API密钥、SSH密钥）不能直接入库。新设备初始化时仍需运行安装脚本。符号链接方式对不熟悉Git和Unix的用户来说概念较难理解。

五、注意事项与最佳实践

5.1 安全注意事项

迁移过程中最重要的原则是保护敏感信息。SSH密钥、API Token、数据库密码这些绝对不能通过Git仓库或任何公开渠道传输。

#!/bin/bash
# 技术栈: Shell Scripting (Bash)
# 功能: 安全地管理敏感配置信息

# 方案: 使用环境变量文件存储敏感信息（加入.gitignore）
cat > ~/.dev.env << 'ENV'
# 此文件不应被提交到Git仓库
GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
DATABASE_URL=postgresql://user:password@localhost:5432/mydb
STRIPE_API_KEY=sk_live_xxxxxxxxxxxxxxxxxxxxxxxxx
ENV

# 设置文件权限为仅所有者可读写
chmod 600 ~/.dev.env

# 在shell配置中加载该文件
echo 'source ~/.dev.env' >> ~/.zshrc  # 添加到.zshrc的末尾
source ~/.dev.env  # 立即生效

# 验证敏感变量是否可用
echo "GitHub Token状态: $([ -n "$GITHUB_TOKEN" ] && echo '已设置' || echo '未设置')"

5.2 性能优化建议

迁移脚本虽然方便，但如果写得不好，执行一次可能要花好长时间。以下是几个关键的优化点。

#!/bin/bash
# 技术栈: Shell Scripting (Bash)
# 功能: 环境迁移脚本的性能优化技巧

# 优化1: 并行安装Homebrew包（显著缩短总安装时间）
echo "并行安装模式..."
brew install --parallel=8 git node python docker jq 2>/dev/null

# 优化2: 跳过不需要的包依赖，只安装叶子包
# 这样可以避免安装一堆用不上的间接依赖
brew leaves > /tmp/core-packages.txt
xargs brew install --skip-update < /tmp/core-packages.txt

# 优化3: 使用缓存加速npm安装
npm config set cache $HOME/.npm-cache
npm install -g typescript eslint --prefer-offline --no-audit

# 优化4: 批量清理操作放在最后统一执行
echo "清理阶段..."
brew cleanup --prune=all    # 清理Homebrew缓存
npm cache clean --force      # 清理npm缓存
rm -rf ~/Library/Caches/com.apple.dt.Xcode*  # 清理Xcode缓存

# 优化5: 记录执行时间，便于后续优化
echo "各步骤执行时间记录:"
echo "建议: 将耗时步骤的结果缓存，下次执行时跳过"

5.3 常见问题排查

#!/bin/bash
# 技术栈: Shell Scripting (Bash)
# 功能: 常见迁移问题的诊断与修复

# 问题1: 命令找不到（最常见的问题）
check_command() {
    local cmd="$1"
    if ! command -v "$cmd" &>/dev/null; then
        echo "错误: 命令 '$cmd' 找不到"
        echo "请检查:"
        echo "  1. 是否已安装: brew install $cmd"
        echo "  2. PATH是否正确: echo \$PATH"
        echo "  3. 是否需要更新: brew update && brew upgrade"
        return 1
    fi
    echo "命令 '$cmd' 正常: $(which $cmd)"
    return 0
}

# 问题2: 权限被拒绝
check_permissions() {
    echo "检查关键目录权限..."
    local dirs=(
        "$HOME/.ssh"
        "$HOME/.nvm"
        "$HOME/.pyenv"
        "$HOME/.npm"
    )
    
    for dir in "${dirs[@]}"; do
        if [ -d "$dir" ]; then
            local perms=$(stat -f "%Lp" "$dir")
            echo "  $dir -> 权限: $perms"
        else
            echo "  $dir -> 目录不存在，请创建"
        fi
    done
}

# 问题3: 版本冲突
check_version_conflict() {
    echo "检查常见版本冲突..."
    
    # Node.js版本检查
    local node_major
    node_major=$(node -v 2>/dev/null | sed 's/v//' | cut -d. -f1)
    if [ -n "$node_major" ]; then
        echo "  Node.js主版本: v${node_major}.x.x"
        if [ "$node_major" -lt 18 ]; then
            echo "  警告: 建议升级到Node.js 18+"
        fi
    fi
    
    # Python版本检查
    local python_version
    python_version=$(python3 --version 2>/dev/null)
    echo "  Python版本: $python_version"
}

# 运行所有诊断
echo "===== 开始诊断 ====="
check_command "git"
check_command "node"
check_command "npm"
check_command "python3"
check_permissions
check_version_conflict
echo "===== 诊断完成 ====="

六、总结

macOS开发环境迁移的核心思路其实很简单：把你能配置的东西都变成文本文件，把这些文本文件纳入版本控制，然后用自动化脚本把它们在新设备上重新部署一遍。具体来说，以下几个要点值得牢记：

第一，尽早建立Dotfiles仓库。不要等到换设备才开始想怎么迁移，平时就把你的配置文件管理好。每修改一次重要配置，就提交一次Git，这样你的配置文件就有了完整的版本历史。

第二，写一个一键部署脚本。这个脚本不需要完美，只要能让你的核心开发工具（Git、Node.js、Python、Homebrew等）在新设备上快速恢复即可。脚本跑完后，个别工具的精细化配置可以手动补充。

第三，区分敏感信息和普通配置。API密钥、数据库密码这类信息绝对不要放进Git仓库，用环境变量文件或者加密的钥匙串来管理。

第四，理解你的芯片架构。Apple Silicon和Intel Mac在路径、权限、兼容性上存在大量差异，自动检测并适配芯片架构是迁移脚本中最容易被忽略但最重要的环节。

第五，保持环境可重复性。你的迁移脚本在新电脑上应该能得到完全相同的结果。如果某些步骤依赖于GUI操作或者手动确认，至少要在脚本中明确标注出来，让执行者知道需要人工介入。

环境迁移不是痛苦的事情，只要你把功夫下在平时，把配置管理当成一个长期的工程来做，每次换新设备时，真正的恢复时间可以缩短到半小时以内。与其每次都在零散的手工操作中消磨时间，不如花几个小时搭建一套完整的自动化迁移体系，这会成为你开发生涯中回报率最高的投资之一。