hygroupseries

Mac mini 前端开发环境配置记录

4 分钟阅读 更新于 

背景

这次配置 Mac mini 的目标很明确：搭一台安静、省电、稳定的桌面开发机。我的主要工作集中在前端开发、技术写作和少量命令行自动化，所以环境配置的重点不是装很多软件，而是把基础工具链整理得足够顺手。

这篇文章不聊跑分，只记录我从空系统到可投入开发的配置流程。如果你刚开始使用 macOS 做前端开发，也可以把它当作一份基础清单。

问题分析

新 Mac 到手后，最容易遇到的不是“不会安装软件”，而是“环境不统一”：

  • 没有包管理器，很多命令行工具只能手动找安装包。
  • 终端、编辑器、AI 工具分散，快捷键和配置不一致。
  • 一开始随手装软件，后续迁移和重装成本会越来越高。

如果不在第一天把工具链打好，后面每天都会被细碎问题打断。开发环境的价值不在于“装得全”，而在于常用路径是否稳定、可复现、可迁移。

方案设计

我的结论是：先用 Homebrew 管理安装入口，再按“终端 -> 编辑器 -> 运行时 -> 项目工具”的顺序搭建。这样安装路径清楚，后续升级和迁移也更容易。

方案一：统一使用 Homebrew

统一用 Homebrew 安装核心工具：

  • 优点：命令统一、更新简单、卸载干净。
  • 缺点：第一次配置需要理解 brew、cask 和环境变量。
  • 适用场景：希望长期维护开发环境的人。

方案二：使用官网安装包

全部使用官网安装包：

  • 优点：上手直观，不需要命令行基础。
  • 缺点：版本管理分散，后续维护成本高。
  • 适用场景：临时使用或只装极少工具。

我最终采用方案一，只有个别工具在 Homebrew 不稳定或版本落后时再回退到官网安装包。

实现过程

下面是我在 Mac mini 上采用的一套顺序。

第一步：安装 Homebrew

先打开“终端”执行官方安装命令：

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

安装完成后，根据终端提示把 Homebrew 加入 shell 环境（Apple Silicon 通常是 /opt/homebrew/bin/brew）：

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

建议顺手做一次基础校验：

brew doctor
brew update

第二步：安装 Ghostty 作为主力终端

我选择 Ghostty 的原因是启动快、渲染流畅、默认体验干净，适合高频命令行工作。终端不需要复杂，但要稳定、清晰、打开就能用。

brew install --cask ghostty

安装后优先做三件事：

  • 打开“开机自动恢复窗口”与“关闭确认”相关选项，减少误操作。
  • 统一字体与行高，保证中英混排可读性。
  • 把默认 shell 确认成 zsh，避免脚本行为不一致。

第三步：安装 VS Code 并接入开发常用能力

brew install --cask visual-studio-code

然后把 code 命令加入 PATH，方便在终端快速打开项目：

cat <<'EOF' >> ~/.zprofile
export PATH="$PATH:/Applications/Visual Studio Code.app/Contents/Resources/app/bin"
EOF
source ~/.zprofile
code --version

我会优先安装这些扩展类型：

  • 语言支持：TypeScript、JSON、Markdown。
  • 代码质量：ESLint、Prettier。
  • 工作流：GitHub Pull Requests、GitLens。

第四步：安装基础开发工具链

虽然这篇重点是四个应用，但实际开发还需要最小工具链：

brew install git node pnpm
node -v
pnpm -v
git --version

到这里，一台可用于前端开发和写作的 Mac mini 环境就基本成型了。

关键代码

我把常用安装动作收敛成一段脚本，重装机器时可以直接复用：

# setup-dev.sh
brew update
brew install git node pnpm
brew install --cask ghostty visual-studio-code
brew cleanup

这段脚本的价值不在“省几分钟”，而在于让环境配置可重复。你可以把它放进 dotfiles 仓库，未来换机器时只要执行一次就能恢复 80% 的工作状态。

注意事项

  • Apple Silicon 与 Intel 的 Homebrew 路径不同，教程里的路径不要盲抄。
  • 安装 GUI 应用前确认网络和系统版本，失败时先 brew update 再重试。
  • 新机器建议先完成系统更新，再大规模安装开发工具。
  • 如果公司网络有代理或证书策略，先处理网络再执行安装命令。
  • 重要配置建议托管到 Git 仓库，例如 shell 配置、编辑器配置和安装脚本。

总结

Mac mini 给我的第一印象是稳定、安静、专注，尤其适合长时间写代码。开发环境配置上，Homebrew 是整个流程的支点，先搭好它再装应用会顺很多。Ghostty 负责高频命令行，VS Code 负责主编辑流，Node.js 和 pnpm 支撑前端项目运行。后续如果要继续升级，我会优先从 dotfiles 自动化和项目模板化两条线开始。

← 所有文章

评论