# macinit

**Repository Path**: coderxslee/macinit

## Basic Information

- **Project Name**: macinit
- **Description**: dotfilesdotfilesdotfilesdotfilesdotfiles
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-07-23
- **Last Updated**: 2025-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Mac 初始化脚本

## ✨ 项目简介

本项目为 macOS 用户量身打造的一键式系统初始化脚本，集成了 Homebrew 安装、开发环境配置、zsh 环境美化、iTerm2 配置等功能，让你的 Mac 快速变身为高效的开发工作站。

---

## 🏗️ 功能特性

### 🔐 系统安全设置
- 一键允许所有来源应用安装
- 可选择关闭自动重新加载

### 🍺 Homebrew 智能安装（支持多镜像源）
- **官方源**（GitHub，适合网络条件好的用户）
- **中科大源**（推荐，国内用户首选）
- **清华大学源**
- **上海交通大学源**
- **阿里巴巴源**
- 自动检测系统架构（Apple Silicon M1/M2 或 Intel）
- 智能处理已有 Homebrew 安装（备份、重装或跳过）
- 自动配置环境变量和镜像源

### 🔤 字体安装
- 自动安装 Fira Code 程序员专用字体

### 💻 iTerm2 配置
- 自动安装 iTerm2 最新版
- 可选导入李雪松专用配置（dotfiles）
- 自动安装 oh-my-zsh 及常用插件
- 自动安装 zsh-autosuggestions（历史命令自动提示）
- 自动安装 zsh-syntax-highlighting（语法高亮）
- 自动安装 agnoster 主题
- 自动下载并配置个人化 .zshrc
- 自动配置 Terminal.app 主题
- **自动备份**原有配置，防止误覆盖

### 🛠️ 开发环境一键安装
- **FVM**（Flutter 版本管理）
- **NVM**（Node.js 版本管理）
- **jenv**（Java 版本管理）
- **uv**（Python 包管理工具）
- **pyenv**（Python 版本管理）
- 智能检测安装状态，避免重复安装

---

## 🚀 快速开始

### 方法一：直接运行（推荐）
```bash
bash -c "$(curl -fsSL https://gitee.com/coderxslee/macinit/raw/master/install.sh)"
```

### 方法二：克隆仓库运行
```bash
git clone https://gitee.com/coderxslee/macinit.git
cd macinit
chmod +x install.sh
./install.sh
```

---

## 📷 效果展示

### Homebrew 安装界面
![Homebrew 安装效果图](./assets/images/iShot_2025-07-23_19.43.14.png)

### 主菜单界面
![脚本主菜单](./assets/images/iShot_2025-07-23_13.51.02.png)

### 安装完成效果
![安装完成效果图](./assets/images/iShot_2025-07-23_15.26.49.png)

### 已安装状态
![已安装效果图](./assets/images/iShot_2025-07-23_13.55.06.png)

### 开发环境安装
![开发环境安装效果图](./assets/images/iShot_2025-07-23_19.17.41.png)

---

## 🙋 常见问题

**Q: 脚本会覆盖我现有的配置吗？**
- A: 会备份原有配置后再覆盖，可随时恢复。

**Q: 支持重复运行吗？**
- A: 支持，已安装的组件会自动跳过。

**Q: 如何选择 Homebrew 镜像源？**
- A: 脚本会提供5个选项，国内用户推荐选择中科大源。

**Q: 安装失败怎么办？**
- A: 脚本有详细的错误提示，按提示操作即可，或查看日志排查问题。

**Q: 如何卸载安装的内容？**
- A: Homebrew 可用官方卸载脚本，其他配置可通过备份文件恢复。

---

## 🤝 参与贡献

1. Fork 本仓库
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

---

## 📄 开源协议

本项目采用 MIT 协议，详见 [LICENSE](LICENSE) 文件。

---

## 🔗 相关链接

- [作者博客](https://coderxslee.gitee.io)
- [Gitee 优秀开源项目](https://gitee.com/explore)
- [Homebrew 官网](https://brew.sh)
- [Oh My Zsh 官网](https://ohmyz.sh)

---

> 让 Mac 配置变得简单，让开发更加高效！🚀
> 
> 如有问题或建议，欢迎提 Issue 或 PR！✨