macOS 初始配置指南

Question

现在对于新机的新鲜感只剩下两分钟了，其余就是漫长的软件安装与配置过程，属实累...
将一些长期使用的软件分享一下吧。

一、相关软件

常用软件

• Chrome 浏览器，日常使用最多的软件，没什么好说的，历史版本戳这里。
• Firefox 浏览器，开发者版本，调试 CSS 很棒。
• Edge 浏览器，基于 Chromium，但颜值打不过 Chrome。
• 搜狗输入法，自定义短语设置很不错。
• Visual Studio Code，前端必备吧。
• HandShaker，连接 Android 设备进行文件管理，老罗出品，但多年不更新了。
• ClashX，你懂的。
• iShot，免费的截图工具。可惜更喜欢的截图（Jietu）不再更新了。
• Diagram，软件开发作图软件，免费、强大且完善，有网页版、桌面版。
• CleanMyMac X，MacPaw 出品，是 macOS 里较为受欢迎的垃圾清理、软件卸载工具。

系统增强软件

• Alfred，或许是比内置 Spotlight 更好的选择，生态上也有很多便捷、好用的 Workflows。
• XtraFinder，Finder 增强插件，可惜颜值没跟上最新的 Finder。
• TotalFinder，Finder 增强插件，可实现类似 Chrome 的多标签。
• Scroll Reverser，还在为 macOS 触控板、鼠标的“自然”方向抓狂？试试这个吧。同时如果你认为它是反人类的，不妨了解下 Apple 自家鼠标有无滚轮的问题。
• Itsycal for Mac，菜单栏日历增强插件，颜值能打，而且可以在菜单栏查看日程等交互。
• QuickLook 常用插件，Finder 快速预览增强插件，比如一些语法高亮等。
• Oh My Zsh，zsh Shell 增强，免掉繁琐的 zsh 配置，使得终端更加便捷高效。额外推荐一个很不错的插件 zsh-autosuggestions，提供历史命令提示。
• Dark Themer，一个自定义的 Dark Mode 系统终端描述文件，颜值还不错，配合 Oh My Zsh 味更佳。

问题记录：

• 【2022.11.11】目前 XtraFinder、TotalFinder 暂未完全兼容最新的 macOS Ventura 系统。比如 TotalFinder 导致右键无法正常使用，相关问题 Ventura problems。
• 【2022.11.11】若在 macOS Ventura 使用 Itsycal 遇到崩溃问题，请看 Blog/Ventura。

开发软件

主要是 Web 前端相关。

• Node.js，历史版本请看此处。
• 微信小程序开发工具，没什么好说的。
• 支付宝小程序开发工具，没什么好说的。
• Visual Studio Code，登录后可同步设置、快捷方式、插件及 UI 等，真香！
• Sourcetree，虽然大部分都在用命令行，但有时候看 Log 还是需要用到它。

问题记录：

• 【2022.11.13】macos trustd securityd CPU 过高问题
• 【2022.03.22】解决 Sourcetree 报错 Couldn't posix_spawn: error 2 问题
• 【2020.09.29】Sourcetree 跳过注册

二、macOS 相关设置

试图通过安装插件、修改默认配置的形式，使得 macOS 用得更加称心...

打开「任何来源」

$ sudo spctl –master-disable

分享一个图形化打开「任何来源」的小工具，可从这里获取。

• 保护 Mac 不受恶意软件侵害
• 通过覆盖安全性设置来打开 App

触控板的三指拖移功能

默认情况下，使用触控板要在顶部「按下 + 移动」才能拖移窗口，然后有更方便的是「三指拖移」。

前往「系统偏好设置 - 辅助功能 - 指针控制（或鼠标与触控板） - 触控板选项 - 拖动样式」，选择「三指拖移」。详情

触控板设置

个人习惯，调整两处：

• 开启「轻点来点按」，这样就不用按下触控板来实现鼠标单击效果了。
• 将「在全屏幕显式的应用程序之间轻扫」调整为「四指左右轻扫」，这样触发成功率更高，相比三指会更舒服些。

修改滚轮鼠标的滚动方向

严格来说 macOS 默认的「自然方向」，个人认为是符合「触控」场景的。这点与手机体验是一致的，应该没有人认为手机触控屏的滑动方向是反人类的吧。

那么在 macOS 上为什么备受争议呢？原因很简单，绝大多数人都是从 Windows 操作系统开始接触电脑的，加之市面上绝大多数的鼠标也是「滚轮式」的，在身体已经形成条件反射之后，初次接触到 macOS 的自然方向式的操作之后，是显然会抵触的，自然会被人视为「反人类」。但是 Apple 自家的 Magic Mouse 一直都是「触控式」的啊，它没有滚轮，因此它的滑动的方向与触控板一致逻辑上是正确的。

虽然但是...，由于平常用得最多的是滚轮鼠标，因此我也会使用第三方插件去调整鼠标的滚动方向 Scroll Reverser。

配置 LaunchPad 图标大小

以 MacBook 为例，对于默认一屏 7 × 5 的图标数量，个人认为应用图标稍大。因此，这里调整为 9 × 6，这样小屏下观感更佳。

# 行数量
$ defaults write com.apple.dock springboard-columns -int 9

# 列数量
$ defaults write com.apple.dock springboard-rows -int 6

# 重置 LaunchPad
$ defaults write com.apple.dock ResetLaunchPad -bool TRUE

# 杀掉 Dock 栏进程
$ killall Dock

如需恢复默认状态，如下：

$ defaults write com.apple.dock springboard-columns -int Default
$ defaults write com.apple.dock springboard-rows -int Default
$ defaults write com.apple.dock ResetLaunchPad -bool TRUE
$ killall Dock

QuickLook 插件

使用「空格键」以快速预览是 macOS 的一大特色。可某些文件类型并不支持预览器内容，可通过安装插件的形式来扩展。请移步：QuickLook 常用插件。

Finder 增强

按住 Option 键，拖动窗口大小，可用于调整每次打开 Finder 窗口的默认尺寸。

虽然 Finder 的颜值越来越好，但架不住功能简陋。比如，创建一个 TXT 的纯文本文件，如果不用命令行的话，你能想到其他办法吗？推荐两个增强插件：

• XtraFinder
• TotalFinder

最新版均支持 macOS Monterey。但目前对 macOS Ventura 兼容性不好，比如 TotalFinder 导致右键无法使用。

Finder 隐藏文件

目前 XtraFinder 不兼容 macOS Ventura，可暂时使用快捷键：Command + Shift + .。

终端命令如下，但体验不好，不 killall 的话，不会刷新。

# 显示「隐藏文件」
$ defaults write com.apple.Finder AppleShowAllFiles YES; killall Finder;

# 不显示「隐藏文件」
$ defaults write com.apple.Finder AppleShowAllFiles NO; killall Finder;

三、开发相关

Command Line Tools

安装一些基础命令行工具的前提，属实是万恶之源。

$ xcode-select --install

当然安装那十几 GB 的 Xcode 也是可以的。

Homebrew

无论是图形化界面的软件，还是命令行式的工具，都能使用它来完成，非常的方便。包括本文所提内容，都用它来安装。

安装与切换国内镜像源，看这篇文章即可：Homebrew 使用详解，macOS 的第二个 Mac App Store!。

若安装过程中，遇到以下这些问题：

xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun

使用终端工具执行命令：xcode-select --install 以重新安装 Command Line Tools。一般情况，跨版本安装 macOS 系统也可能需要重新安装。

curl: (7) Failed to connect to raw.githubusercontent.com port 443: Connection refused

跟 DNS 有关系，可看：如何解决类似 curl: (7) Failed to connect to raw.githubusercontent.com port 443: Connection refused 的问题。

Git 相关

安装 Git：

$ brew install git

生成、设置 SSH Key：

# 生成公钥、密钥
$ ssh-keygen -t rsa -C '<your-email-address>' -f ~/.ssh/id_rsa

# 将私钥加入 ssh-agent
$ ssh-add ~/.ssh/id_rsa

# 拷贝公钥
$ cat ~/.ssh/id_rsa.pub | clipcopy

# 将公钥添加到对应平台...

全局配置 Git：

$ git config --global user.name "your-username"
$ git config --global user.email "your-email-address"
$ git config --global init.defaultBranch "main"

相关链接：

• Git 配置多个 SSH-Key
• SSH 密钥登录

Node 相关

Node 安装包（含 NPM 工具），最新版，历史版本（或这里）。

yarn

其中 v1 和 v2 使用区别较大，个人目前仍在用 yarn v1 版本。

# 安装
$ npm i yarn@1 -g

# 配置路径
$ echo 'export PATH="$HOME/.yarn/bin:$PATH"' >> ~/.zshrc

cnpm

为什么不推荐使用 cnpm？

镜像源管理

推荐 nrm 和 yrm 两个工具快速切换和管理镜像源。

• nrm 使用详解
• 一个比 nrm 更好用的镜像源管理工具