MacOS 13.7.8版本-前端环境一键搭建指南

MacOS 13.7.8 前端环境搭建完全指南

一、先安装Git（系统适配版）

macOS 13.7.8本身自带Git，但版本可能较旧，推荐升级为最新稳定版，两种方式任选：

方式1：用系统自带命令行工具快速安装（最简）

Bash 复制代码

# 触发系统自带Git安装（会自动安装适配13.7.8的Command Line Tools）
xcode-select --install

执行后弹出安装窗口，点击"安装"→"同意协议"，等待5-10分钟完成即可。

验证Git安装：

Bash 复制代码

# 查看Git版本
git --version
# 输出示例：git version 2.39.3 (Apple Git-145)

二、安装前端核心环境（Node.js + npm/yarn）

针对macOS 13.7.8，优先用nvm管理Node.js（避免权限问题，适配性最好）：

步骤1：安装nvm（适配13.7.8的稳定版本）

安装nvm（国内镜像，避免下载超时）

Bash 复制代码

curl -o- https://gitee.com/mirrors/nvm/raw/v0.39.7/install.sh | bash

配置nvm环境变量（必做，适配zsh）

Bash 复制代码

echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc

Bash 复制代码

echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.zshrc

Bash 复制代码

source ~/.zshrc

验证nvm

Bash 复制代码

nvm --version

Bash 复制代码

# 输出：0.39.7 即成功

步骤2：安装Node.js（适配13.7.8的LTS版）

macOS 13.7.8推荐安装Node.js 18.16.1 LTS（最高兼容版本）：

Bash 复制代码

# 安装18.16.1 LTS版
nvm install 18.16.1

Bash 复制代码

# 设置为默认版本
nvm alias default 18.16.1

Bash 复制代码

# 验证Node和npm
node -v  # 输出：v18.16.1（或相近版本）
npm -v   # 输出：9.5.1（或相近版本）

步骤3：优化npm下载速度（国内镜像）

Bash 复制代码

# 配置淘宝镜像（适配13.7.8）
npm config set registry https://registry.npmmirror.com
# 验证镜像
npm config get registry
# 输出：https://registry.npmmirror.com 即成功

步骤4：可选安装yarn（前端常用包管理器）

Bash 复制代码

# 全局安装yarn
npm install -g yarn

# 验证yarn
yarn --version
# 输出：1.22.21 即成功

三、Git基础配置（前端开发必备）

安装完成后，配置Git用户名和邮箱（关联代码仓库）：

Bash 复制代码

# 配置全局用户名（替换为你的名字）
git config --global user.name "Your Name"

# 配置全局邮箱（替换为你的Git账号邮箱）
git config --global user.email "your_email@example.com"

# 查看配置是否生效
git config --list
# 能看到user.name和user.email即为配置成功

四、常见问题解决（针对13.7.8版本）

问题1：终端提示"Permission denied"（权限不足）

Bash 复制代码

# 修复nvm目录权限
sudo chown -R $USER:$GROUP ~/.nvm

# 修复Homebrew目录权限
sudo chown -R $(whoami) /opt/homebrew

问题2：nvm/git命令找不到

Bash 复制代码

# 重新加载zsh配置
source ~/.zshrc

# 重启终端后重试

五、验证完整环境

执行以下命令，全部输出版本号即说明环境搭建完成：

Bash 复制代码

# 验证Git
git --version

# 验证Node
node -v

# 验证npm
npm -v

# （可选）验证yarn
yarn --version