user-quickstart.md

MacSetup 快速入门指南

欢迎使用 MacSetup！这个工具可以帮你快速设置一台全新的 Mac，让它变成你理想的工作环境。

🚀 5分钟快速上手

第一步：确保你的 Mac 准备就绪

在开始之前，请确保：

• ✅ macOS 版本为 10.15 (Catalina) 或更新版本
• ✅ 至少有 5GB 的可用存储空间
• ✅ 连接到互联网
• ✅ 你有管理员账户权限

第二步：下载并运行 MacSetup

# 在终端中运行这一行命令即可开始
./init.sh

这会启动一个友好的向导，引导你完成整个设置过程。

第三步：选择你的使用场景

MacSetup 会询问你是什么类型的用户：

🎯 推荐选择：

• 开发者 - 如果你要写代码、做程序开发
• 设计师 - 如果你主要做设计、创意工作
• 学生/办公 - 如果你主要用来学习、办公
• 自定义 - 如果你想完全控制安装什么

第四步：确认并开始安装

向导会显示将要安装的内容，确认后开始自动安装。你可以去泡杯咖啡，通常需要 20-60 分钟完成。

🎯 我应该选择什么？

如果你是开发者

建议选择"开发者"配置

将会安装：

• 📦 开发工具：Git、Node.js、Python、Docker 等
• 🛠 编辑器：VS Code、iTerm2
• ⚙️ 系统优化：显示隐藏文件、优化终端设置

如果你是设计师

建议选择"设计师"配置

将会安装：

• 🎨 设计软件：Figma、Sketch、Adobe Creative Cloud
• 🖼 图像工具：ImageOptim、Photoshop
• 💻 系统优化：色彩管理、字体管理

如果你是学生或办公用户

建议选择"学生/办公"配置

将会安装：

• 📄 办公软件：Microsoft Office、Pages、Numbers
• 🌐 浏览器：Chrome、Firefox
• 📊 实用工具：Alfred、1Password、CleanMyMac

如果你想完全自定义

选择"自定义"配置

你可以：

• ✅ 选择要安装哪些软件
• ✅ 决定是否修改系统设置
• ✅ 控制每一个细节

⚡️ 常用命令

最简单的使用方式

./init.sh

启动向导，适合第一次使用

如果你很确定要什么

./init.sh --profile developer --yes

直接使用开发者配置，不询问确认

如果只想安装软件，不改系统设置

./init.sh --packages-only

如果想先看看会做什么

./init.sh --dry-run

预览模式，不会实际安装任何东西

🛟 遇到问题怎么办？

安装过程卡住了

按 Ctrl+C 停止，然后重新运行 ./init.sh。脚本会跳过已经安装的内容。

某些软件安装失败

这很正常！MacSetup 会继续安装其他软件，最后告诉你哪些失败了。你可以稍后手动安装。

不知道选哪个配置

选择"开发者"配置是最安全的选择，包含了大多数人需要的工具。

想撤销所有更改

查看 常见问题解答

💡 使用小贴士

第一次使用

• 建议先用 --dry-run 看看会安装什么
• 确保网络连接稳定
• 准备好你的 Apple ID（某些 App Store 应用需要）

安装完成后

• 重启终端让所有设置生效
• 检查 Applications 文件夹查看新安装的应用
• 根据需要登录各种账户（如 Google、GitHub 等）

以后再次使用

• 可以创建自己的配置文件
• 用来设置新的 Mac 或重装系统后恢复环境
• 与团队分享配置，保持开发环境一致

📱 我的 Mac 现在有什么？

安装完成后，你的 Mac 会有：

在应用程序文件夹

• 🚀 所有选择的应用程序
• 💻 开发工具（如 VS Code、iTerm2）
• 🌐 浏览器和网络工具

在终端中

• 📦 Homebrew 包管理器
• 🛠 各种命令行工具
• 🔧 配置好的开发环境

系统设置优化

• 🎨 更好的 Dock 和 Finder 设置
• ⌨️ 优化的键盘和触控板设置
• 🔒 增强的安全设置

🆘 需要帮助？

• 📖 查看 常见问题解答
• 🔧 遇到错误？查看 问题解决指南
• 💬 需要更多帮助？提交问题

---

下一步：查看 使用场景指南 了解更多高级用法，或直接开始使用 ./init.sh！