初始化我的 MacBook

这个文档的目的是每次拿到新的 MacBook 时，方便快速初始化笔记本，安装必备工具并记录必要的配置。也是想收集大家平时好用的软件，及时体验上新的好工具

🔗 相关链接

GitHub 仓库: https://github.com/Chiaki-xps/init-my-macbook
在线文档: https://chiaki-xps.github.io/init-my-macbook/
提供您认为好用的软件: GitHub Issues

如何贡献这个文档

建议通过 Issue 或 Pull Request 提交修改。合并前我会逐一验证每个软件的安装与使用。对于功能重叠或类型相近的软件，我会在文档中合并对比，并给出推荐项。建议在 PR 中附上变更说明、测试环境与必要截图。

1. 📦 软件安装

1. Homebrew（包管理器）

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

# 验证是否成功
brew --version

官网地址： https://brew.sh/zh-cn/

2. Visual Studio Code

brew install --cask visual-studio-code

安装 code 命令：

打开命令面板：Cmd + Shift + P
输入 shell command
选择并运行：Shell Command: Install 'code' command in PATH

3. Cursor

brew install --cask cursor

导入 VS Code 配置：首选项 → Cursor Setting → Import Settings from VS Code

这里提供一下导入vscode插件失败的方案（谨慎使用，因为Cursor最新版本和VS Code部分插件存在兼容问题）

# 找到 cursor 程序下 product.json
code /Applications/Cursor.app/Contents/Resources/app/product.json

找到 extensionsGallery，将其中 https://marketplace.cursorapi.com 改成 https://marketplace.visualstudio.com
重启，重新导入就可以了，记得还原文件

4. Markdown 编辑器

Typora：下载地址： https://xclient.info/s/typora.html
- 页面简洁，个人感觉展示效果更好，但是收费。低版本免费。
Obsidian：下载方式：brew install --cask obsidian
- 功能强大，基础功能免费

5. QQ、WeChat、腾讯会议

brew install --cask wechat qq tencent-meeting

⚠️ 记得修改存储路径

6. Mos（鼠标滚动方向调整）

brew install --cask mos

7. 有道词典

brew install --cask youdaodict

8. Snipaste（截图工具）

brew install --cask snipaste

9. FNM（Node.js 版本管理）

brew install fnm

配置 FNM：

编辑配置文件：code ~/.zshrc

添加以下配置：

# fnm 配置
eval "$(fnm env --use-on-cd)"

重新加载配置：source ~/.zshrc
设置默认版本：fnm default <版本号>

10. 系统清理

CleanMyMac X：下载地址： https://www.macwk.com/soft/cleanmymac-x
腾讯柠檬清理（tencent-lemon）：brew install --cask tencent-lemon

11. 网易云音乐

brew install --cask neteasemusic

12. 超级右键

下载地址： https://macked.app/irightmouse-crack.html

⚠️ 将 Cursor 添加到右键菜单

13. LuLu 安全网络防火墙

下载地址： https://github.com/objective-see/LuLu/releases

特点：开源、安全防控

14. Navicat

Navicat lite: 免费正版：https://www.navicat.com/en/download/navicat-premium-lite

Navicat Pro：自行寻找

15. lxmusic

软件本体：https://github.com/lyswhut/lx-music-desktop

音乐源（进 dc 查找）：https://antfe.com/dc

16. maczip

下载：https://ezip.awehunt.com

17. Microsoft Office

https://github.com/alsyundawy/Microsoft-Office-For-MacOS?tab=readme-ov-file

3. 🚀 Node.js 环境配置

安装包管理工具

# 安装 nrm（npm 源管理）
npm install nrm -g

# 安装 pnpm（快速包管理器）
npm install pnpm -g

# ARM Mac 需要安装 Rosetta 以支持低版本 Node
/usr/sbin/softwareupdate --install-rosetta --agree-to-license

4. 🖥️ 终端配置

1. iTerm2

brew install --cask iterm2

设置为默认终端：

打开 iTerm2
菜单栏：iTerm2 → Make iTerm2 Default Term

2. Oh My Zsh

# 安装 Oh My Zsh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

3. Dracula 主题

# 克隆主题仓库
git clone https://github.com/dracula/iterm.git

安装步骤： https://draculatheme.com/iterm

4. zsh-autosuggestions（命令自动补全建议插件）

brew install zsh-autosuggestions

在 ~/.zshrc 的 plugins 数组中添加 zsh-autosuggestions，然后执行 source ~/.zshrc。

如果出现 “zsh-autosuggestions 找不到” 的报错，可按架构选择正确路径并追加到 ~/.zshrc：

Apple 芯片（Homebrew 默认前缀 /opt/homebrew）

echo 'source /opt/homebrew/share/zsh-autosuggestions/zsh-autosuggestions.zsh' >> ~/.zshrc
source ~/.zshrc

Intel 芯片（Homebrew 默认前缀 /usr/local）

echo 'source /usr/local/share/zsh-autosuggestions/zsh-autosuggestions.zsh' >> ~/.zshrc
source ~/.zshrc

验证是否生效：打开新终端，输入部分命令应出现灰色联想；或执行

grep -n "zsh-autosuggestions.zsh" ~/.zshrc

5. zsh-syntax-highlighting（语法高亮插件）

brew install zsh-syntax-highlighting

5. 🔧 VSCode 扩展与配置


> 待补充

## 6. 🔑 Git 配置

### 1. 生成 SSH 密钥

```bash
# 生成新的 SSH 密钥对
ssh-keygen -t ed25519 -C "your-email@example.com"

# 查看公钥内容
cat ~/.ssh/id_ed25519.pub

# 配置 Git 身份信息（全局）
git config --global user.email "you@example.com"
git config --global user.name "Your Name"

# 仅为当前仓库配置
git config user.email "you@example.com"
git config user.name "Your Name"

2. 配置 GitHub

复制公钥内容
登录 GitHub → Settings → SSH and GPG keys
点击 "New SSH key"
粘贴公钥并保存

7. 🎨 MacBook 系统设置

1. Clash Verge 系统代理工具

https://github.com/clash-verge-rev/clash-verge-rev

8. GoLang 环境

1. 版本号查询

https://github.com/golang/go/tags

2. 安装

brew install goenv

# .zshrc
export GOENV_ROOT="$HOME/.goenv"
export PATH="$GOENV_ROOT/bin:$PATH"
eval "$(goenv init -)"
export PATH="$GOENV_ROOT/shims:$PATH"

goenv install 1.25.0
goenv global 1.25.0

# 为单独项目设置
goenv local 1.25.0

# 切换源吧
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct

9. 数据库

1. PostgreSQL

brew search postgresql
brew install postgresql@17
brew services start postgresql@17

# 废弃了
# echo 'export PATH="/usr/local/opt/postgresql@16/bin:$PATH"' >> ~/.zshrc

# 新的目录
echo 'export PATH="/opt/homebrew/opt/postgresql@17/bin:$PATH"' >> ~/.zshrc

source ~/.zshrc

psql postgres

# 创建用户
CREATE USER vadxq WITH PASSWORD '123456';
ALTER USER vadxq WITH SUPERUSER;

2. redis

brew install redis
brew services start redis
brew services info redis

Name		Name	Last commit message	Last commit date
Latest commit History 18 Commits
build		build
docs		docs
src/css		src/css
static		static
.gitignore		.gitignore
README.md		README.md
docusaurus.config.ts		docusaurus.config.ts
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json
部署.md		部署.md

Folders and files

Latest commit

History

Repository files navigation

初始化我的 MacBook

🔗 相关链接

如何贡献这个文档

1. 📦 软件安装

1. Homebrew（包管理器）

2. Visual Studio Code

3. Cursor

4. Markdown 编辑器

5. QQ、WeChat、腾讯会议

6. Mos（鼠标滚动方向调整）

7. 有道词典

8. Snipaste（截图工具）

9. FNM（Node.js 版本管理）

10. 系统清理

11. 网易云音乐

12. 超级右键

13. LuLu 安全网络防火墙

14. Navicat

15. lxmusic

16. maczip

17. Microsoft Office

3. 🚀 Node.js 环境配置

安装包管理工具

4. 🖥️ 终端配置

1. iTerm2

2. Oh My Zsh

3. Dracula 主题

4. zsh-autosuggestions（命令自动补全建议插件）

5. zsh-syntax-highlighting（语法高亮插件）

5. 🔧 VSCode 扩展与配置

2. 配置 GitHub

7. 🎨 MacBook 系统设置

1. Clash Verge 系统代理工具

8. GoLang 环境

1. 版本号查询

2. 安装

9. 数据库

1. PostgreSQL

2. redis

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages