Mac 装机清单：软件和配置 • 杨鸿肇

基础工具

Clash Verge

下载安装包并安装：Clash Verge
激活订阅配置

Chrome

下载安装包并安装：Chrome
设置为默认浏览器
登录 Google 账号并同步插件

搜狗输入法

下载安装包并安装：搜狗输入法
使用 QQ 登录
设置字体、字号、候选项、扩展功能等

Maccy

下载安装包并安装：Maccy
开启开机自启
修改快捷键为 Cmd + Shift + V，开启自动粘贴

Homebrew

通过指令安装：

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

添加到环境：

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

Fish

通过 brew 安装：
Terminal window
```
1
brew install fish
```

添加受信任终端并设置为默认：

1
fish_path="$(command -v fish)"
2
grep -qxF "$fish_path" /etc/shells || echo "$fish_path" | sudo tee -a /etc/shells
3
chsh -s "$fish_path"

重启终端或者进入 fish shell，然后将 brew 加入 fish 的 PATH：
Terminal window
```
1
fish_add_path /opt/homebrew/bin
```

安装 fisher 插件：

1
curl -sL https://raw.githubusercontent.com/jorgebucaran/fisher/main/functions/fisher.fish | source && fisher install jorgebucaran/fisher

安装 pure 主题：

1
fisher install pure-fish/pure
2
# 如果要删除
3
# fisher remove pure-fish/pure

安装 fzf 插件（搜索历史命令、文件）：
Terminal window
```
1
brew install fzf
2
fisher install PatrickF1/fzf.fish
```
快捷键：
- Control + R：搜索历史命令
- Control + Option + F：搜索文件
安装 z 插件（快速跳转目录）：
Terminal window
```
1
fisher install jethrokuan/z
```

brew 安装一系列工具

执行以下脚本：

1
# LocalSend: 局域网文件传输
2
brew install --cask localsend
3
# VSCode：代码编辑器
4
brew install --cask visual-studio-code
5
# bob：屏幕翻译
6
brew install --cask bob
7
# OrbStack：轻量化 Docker
8
brew install --cask orbstack
9
# uv：Python 包管理器
10
brew install uv
11
# git：版本管理
12
brew install git
13
# gh：GitHub CLI
14
brew install gh
15
# ouch：解压缩
16
brew install ouch
17
# just：命令运行器
18
brew install just
19
# tokei：代码行数统计
20
brew install tokei
21
# rg：快速搜索
22
brew install ripgrep
23
# trash：删除至回收站
24
brew install trash
25
# autocorrect：自动修正文案
26
brew install autocorrect
27
# dprint：自动格式化
28
brew install dprint

项目中添加 dprint.json 配置文件，示例：

1
{
2
    "includes": ["**/*.md"],
3
    "plugins": [
4
        "https://plugins.dprint.dev/markdown-0.21.1.wasm",
5
        "https://plugins.dprint.dev/ruff-0.7.4.wasm"
6
    ]
7
}

Zellij

通过 brew 安装：
Terminal window
```
1
brew install zellij
```
下载字体并安装到字体册：Nerd Fonts
菜单栏：终端 -> 设置 (Command + ,) -> 描述文件 -> 文本。点击字体旁的更改，选择刚才安装的JetBrains Mono Nerd Font。

启用系统剪切板：

1
code ~/.config/zellij/config.kdl
2
# 取消注释掉这行：
3
copy_command "pbcopy"

Ghostty

通过 brew 安装：
Terminal window
```
1
brew install --cask ghostty
```

点击左上角菜单，进入 settings 添加：

1
# 字体设置 (建议使用 Nerd Font 以支持 zellij 的图标)
2
font-family = "JetBrainsMono Nerd Font"
3
font-size = 18
4

5
# true（建议）：显示标题栏；false：隐藏标题栏，获得沉浸感
6
window-decoration = true
7
# 窗口内边距
8
window-padding-x = 8
9
window-padding-y = 8
10

11
# 颜色主题 (Ghostty 自带很多，可以用 `ghostty +list-themes` 查看)
12
theme = GitHub Dark High Contrast

编程相关

VSCode、Cursor

通过 brew 安装 VSCode：
Terminal window
```
1
brew install --cask visual-studio-code
```
下载安装包并安装：Cursor
下载、导入、激活配置并设为默认：VSCode Profile

GitHub 登录

通过 gh 登录：

1
gh auth login
2
# 查看登录状态
3
gh auth status

通过终端指令鉴权：

1
git config --global url."https://<token>@<host>/".insteadOf "https://<host>/"

fnm：Node 环境管理

通过 brew 安装 fnm：
Terminal window
```
1
brew install fnm
```

创建配置文件：

1
mkdir -p ~/.config/fish/conf.d
2
code ~/.config/fish/conf.d/fnm.fish

添加以下内容：

1
# 设置 fnm 路径
2
fish_add_path "$HOME/.local/share/fnm"
3
# 再初始化环境
4
if type -q fnm
5
    fnm env --use-on-cd --shell fish | source
6
end
7
# 启用 pnpm
8
set -gx PNPM_HOME "$HOME/.local/share/pnpm"
9
fish_add_path $PNPM_HOME

初始化并下载 Node：

1
# 初始化 fnm
2
fnm env --use-on-cd --shell fish | source
3
# 重新加载配置
4
source ~/.config/fish/conf.d/fnm.fish
5
# 安装最新的 LTS 版本
6
fnm install --lts
7
# 或者安装特定的版本
8
fnm install 24
9
# 切换并使用
10
fnm use 24
11
# 启用 pnpm
12
corepack enable
13
# 验证
14
node -v
15
npm -v
16
pnpm -v
17
npx -v

bun：JavaScript 运行时工具

通过官方脚本安装并添加路径：

1
curl -fsSL https://bun.sh/install | bash
2
# 添加路径
3
fish_add_path ~/.bun/bin

Go

通过 brew 安装并添加路径：

1
brew install go
2
# 确保 go install 的二进制能全局执行
3
fish_add_path (go env GOPATH)/bin
4
# 创建常见目录结构
5
mkdir -p ~/go/{bin,pkg,src}

MacTeX

通过 brew 安装并添加路径：

1
brew install --cask mactex
2
# 如果下载之后安装失败
3
# brew reinstall --cask mactex --force
4
fish_add_path /Library/TeX/texbin

格式化工具：

1
brew install cpanminus
2
brew install latexindent
3
# 安装 latexindent 所需的全部 Perl 模块
4
cpanm YAML::Tiny
5
cpanm File::HomeDir
6
cpanm Unicode::GCString

在项目根目录添加 .indentconfig.yaml 文件，示例：

1
 lookForAlignDelims:
2
     align:
3
         delims: 1 # 启用 & 处理
4
         spacesBeforeAmpersand: 1 # & 前 1 空格
5
         spacesAfterAmpersand: 2 # & 后 2 空格
6
         alignDoubleBackSlash: 0 # 不对齐 \\
7
         alignRowsWithoutMaxDelims: 0 # 不对齐不同列数的行
8

9
 # 数学运算符周围的空格
10
 modifyLineBreaks:
11
     preserveBlankLines: 1
12
     condenseMultipleBlankLinesInto: 2     # 允许最多保留两个空行（即标题前可有两行空白）
13

14
     environments:
15
         BeginStartsOnOwnLine: 1       # begin 独占一行
16
         BodyStartsOnOwnLine: 1        # 内容开始新行
17
         EndStartsOnOwnLine: 1         # end 独占一行
18
         EndFinishesWithLineBreak: 1   # end 后换行
19

20
 # 特殊字符周围的空格
21
 specialBeginEnd:
22
     specialBeforeCommand: 0

Miniconda（不推荐，改用 uv）

通过 brew 安装：
Terminal window
```
1
brew install --cask miniconda
```
在终端中激活：
Terminal window
```
1
/opt/homebrew/bin/conda init fish
```

禁用自动激活 base 环境：

1
conda config --set auto_activate_base false
2
source ~/.config/fish/config.fish

AI 编程工具

参考专项笔记：AI 编程工具

其他工具

Office

下载并按教程激活：苹果系统之家

Launch Next（旧版启动台代替）

GitHub 页面

Better Display（显示器设置）

GitHub 页面

PlayCover（iOS 应用模拟器）

官网
获取安装包：MACPA

配置

禁止自动休眠

通过终端指令：

1
sudo pmset sleep 0          # 彻底禁用自动睡眠
2
sudo pmset standby 0        # 可选：禁用深度待机（防止睡死）
3

4
# 查询当前完整状态
5
pmset -g
6

7
# 恢复默认值（sleep 单位为分钟；standby 为 0/1 开关）
8
sudo pmset sleep 10
9
sudo pmset standby 1

快捷键说明：
- Control + Shift + 电源键：关闭显示器/息屏
- Command + Option + 电源键：睡眠整台 Mac

设置菜单栏图标间距

通过终端指令修改：

1
# 修改任务栏图标间距
2
defaults -currentHost write -globalDomain NSStatusItemSpacing -int 6
3
# 修改任务栏图标选中时的间距（通常这个值取上面的 2 倍）
4
defaults -currentHost write -globalDomain NSStatusItemSelectionPadding -int 12
5

6
# 重启控制中心以应用设置（macOS 26 可能需要重启）
7
killall ControlCenter
8

9
# 查询当前值
10
defaults -currentHost read -globalDomain NSStatusItemSpacing
11
defaults -currentHost read -globalDomain NSStatusItemSelectionPadding
12

13
# 恢复系统默认
14
defaults -currentHost delete -globalDomain NSStatusItemSpacing
15
defaults -currentHost delete -globalDomain NSStatusItemSelectionPadding
16
# 重启控制中心以应用设置（macOS 26 可能需要重启）
17
killall ControlCenter

fish 配置

在 ~/.config/fish/config.fish 文件，添加以下内容：

1
fish_add_path $HOME/.local/bin
2
# 快捷指令
3
abbr -a scf 'source ~/.config/fish/config.fish'
4
abbr -a ecf 'cursor ~/.config/fish/config.fish'
5
abbr -a cur 'cursor .'
6
abbr -a ecmd 'cursor ~/.claude/CLAUDE.md'
7
abbr -a eamd 'cursor ~/.codex/AGENTS.md'

字体

思源黑体：GitHub 页面
思源宋体：GitHub 页面

网站

Xclient：Mac 软件下载