devenv

macOS 14 Sonoma 开发环境设置。

前提

1. 系统保持最新版本
2. 登录 iCloud 账号

设置

外观

在系统设置 -> 外观：

• 外观：设置为 深色（个人偏好）
• 显示滚动条：根据鼠标或触控板自动显示

在系统设置 -> 桌面与程序坞：

• 自动隐藏和小时程序坞：开启
• 最小化窗口时使用：神奇效果
• 桌面与台前调度 -> 台前调度：关闭（目前并不成熟）
• 小组件 -> 显示小组件：勾选 桌面上
• 调度中心 -> 切换倒某个应用程序时，会切换倒包含该应用程序的打开窗口的空间：开启
• 调度中心 -> 显示器具有单独的空间：开启

在系统设置 -> 控制中心：

• 自动隐藏和显示菜单栏：永不

个人偏好在 MacBook 中显示菜单栏（有刘海的屏幕隐藏菜单栏实在太丑了），在 Mac 中则隐藏菜单栏以获得更大的显示面积。

隐私和安全

在系统设置 -> 隐私与安全性：

• 敏感内容警告：关闭
• 分析与改进：关闭所有
• 高级 -> 访问系统范围的设置需要输入管理员密码：开启

在系统设置 -> 网络：

• 防火墙：启用

在系统设置 -> 锁定屏幕：

• 屏幕保护程序启动或显示器关闭后需要密码：设定 1 分钟后

在系统设置 -> 通用：

• 时间机器：配置备份的网盘或硬盘（每小时）

在Safari -> 首选项 -> 搜索 ：

• 搜索引擎：修改为谷歌或DuckDuckGo

[!Warning] API 无论是否使用 Safari 作为默认浏览器，一定一定要在搜索引擎中把百度改掉。

编辑和控制

在系统设置 -> 桌面与程序坞：

• 窗口 -> 关闭文稿时要求保存更改：关闭

在系统设置 -> 键盘：

• 键重复速率：拉到右边倒数第二个
• 重复前延迟：拉到右边倒数第二个

在系统设置 -> ** 触控板**：

• 光标与点按 -> 轻点来点按：开启
• 滚动缩放：开启所有

在系统设置 -> ** 辅助功能** -> 指针控制：

• 触控板选项 -> 使用触控板进行拖移：开启
• 触控板选项 -> 拖移样式：三指拖移

访达

• 通用 -> 开启新 ”Finder“ 窗口时打开：Desktop
• 边栏：去除不需要的项目
• 高级 -> 显示所有文件扩展名：勾选
• 高级 -> 将以下位置的文件夹保持在顶部：选中按名称排序的窗口中和桌面上
• 高级 -> 执行搜索时：搜索当前文件夹

开发

在终端中输入以下命令安装命令行工具：

1
xcode-select --install

许多第三方软件和开发工具都会依赖 xcode-select，所以先提前安装。

包管理

Homebrew 是一款开源的包管理工具，目前支持 macOS 和 Linux，可以快速的安装和更新软件，通过以下命令安装：

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

3
# 安装完成后执行，以增加到 zsh 配置文件 .zprofile
4
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile

常用命令：

• 搜索：brew search <package>
• 安装：brew install <package>
• 卸载：brew uninstall <package>
• 更新：brew upgrade <package>

默认情况下 brew 许多命令是针对命令行工具的操作，如果要指定 GUI，增加 --cask 参数，更多命令和用法可以参考官方网站。

Git

默认情况下 macOS 已经安装了 Git，如果想用最新版本，可以通过 brew 安装：

1
brew install git

然后配置用户信息：

1
git config --global user.name "Name"
2
git config --global user.email "[email protected]"

user.name 和 user.email 一般是你 GitHub 注册名和邮箱（下面生成密钥用到的邮箱也是）。

生成 SSH 密钥用于通过命令行连接 GitHub：

1
# 生成密钥
2
ssh-keygen -t ed25519 -C "[email protected]"
3
# 拷贝倒剪贴板
4
cat ~/.ssh/id_ed25519.pub | pbcopy

在 Github 添加密钥：

1. 打开 GitHub -> Settings -> SSH and GPG keys 并登录
2. 点击 New SSH key 新建
   • Title：自定义填入标题
   • Key type：Authentication Key
   • Key：粘贴上一步拷贝的密钥
3. 点击 Add SSH key 保存

进行验证密钥是否添加成功：

1
ssh -T [email protected]

正常情况下将会返回：

1
Hi immwind! You've successfully authenticated, but GitHub does not provide shell access.

更多信息可以查看 GitHub 文档。

终端

iTerm2 是 macOS 默认终端的开源代替品，高度可定制性并且支持下拉式呼出，非常方便，通过下面命令安装：

1
brew install --cask iterm2

外观设置

在 Preferences -> Appearance：

• General -> Theme：==Minimal==
• General -> Tab bar location：==Top==
• Windows -> Show window number in title bar：==✔==
• Windows -> Show border around windows：==❌==
• Windows -> Hide scrollbars：==✔==

在 Preferences -> Profiles -> Text：

• Font：修改字体，个人习惯使用 Sarasa Term SC Nerd 字体，并设置为 Bold，字号 13。

在 Preferences -> Profiles -> Window：

• Window Appearance -> Transparency：==42==（透明）
• Window Appearance -> Blur：==24==（模糊）
• Settings for New Windows -> Columns：==120==
• Settings for New Windows -> Style：==normal==

从 Preferences -> Profiles 中拷贝 Profile 用于下拉式呼出终端的配置：在左下角点击 Other Actions，选择 Duplicate Profile 即可。

确保右侧选择的是 Copy of 开头的配置，在 Preferences -> Profiles -> General：

• Basics -> Name：修改配置名称

在 Preferences -> Profiles -> Window：

• Settings for New Windows -> Style：==Full-Width Top of Screen==
• Settings for New Windows -> Space：==All Spaces==

在 Preferences -> Profiles -> Keys：

• General -> A hotkey opens a dedicated window with this profile -> Double-tap key：勾选并选择 Option

配置下拉式呼出终端的快捷键，个人偏好用 Double-tap 呼出，如果不喜欢也可以用 Hotkey 的方式。

美化

可以安装 Oh My Zsh 为 macOS 默认的 zsh Shell 管理 配置和插件：

1
$ sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

等安装完成后，在 zsh 配置中添加一条语句：

1
echo "source $(brew --prefix)/opt/powerlevel10k/powerlevel10k.zsh-theme" >>~/.zshrc

另外安装 zsh 主题 Powerlevel10k ：

1
brew install romkatv/powerlevel10k/powerlevel10k

同样待安装完成后也要在 zshrc 中添加一条：

1
echo "source $(brew --prefix)/share/powerlevel10k/powerlevel10k.zsh-theme" >>~/.zshrc

刷新 zsh 配置：

1
source ~/.zshrc

对 powerlevel10k 主题进行自定义配置：

1
p10k configure

对了，当询问是否安装字体时：“Whether to install Meslo Nerd Font” 时选择 Y，以免一些图标字符显示不全。

编辑器

Nvim

Neovim 之于 Vim，就如 Vim 之于 Vi，都是后者的改进和扩展版本，同时又兼容前者的配置和插件，同样可以通过 brew 安装：

1
brew install neovim

Nvim 现在支持通过 Lua 进行配置，默认配置位于 ~/.config/nvim/init.lua ，等安装完成后，可以根据需要进行设置。

除了基础配置之外，还可以安装第三方主题和插件，推荐使用 lazy.nvim 进行安装和管理第三方插件：

1
# 在 ~/.config/nvim/init.lua 添加
2
local lazypath = vim.fn.stdpath("data") .. "/lazy/lazy.nvim"
3
if not vim.loop.fs_stat(lazypath) then
4
  vim.fn.system({
5
    "git",
6
    "clone",
7
    "--filter=blob:none",
8
    "https://github.com/folke/lazy.nvim.git",
9
    "--branch=stable", -- latest stable release
10
    lazypath,
11
  })
12
end
13
vim.opt.rtp:prepend(lazypath)
14

15
local plugins = {}
16

17
require("lazy").setup(plugins, opts)

如果需要新增插件直接把 GitHub 对应作者和仓库名 添加到 plugins 中即可：

1
local plugins = {
2
    "UtkarshVerma/molokai.nvim", -- 主题
3
    "nvim-lualine/lualine.nvim", -- 状态栏
4
}

VS Code

VS Code以其出色的性能、丰富的功能和强大的扩展性而闻名，号称宇宙第一编辑器。除了智能的代码补全、语法高亮、调试器、版本控制等功能，还拥有庞大的插件生态系统，可以根据自己的需求安装各种插件来扩展编辑器的功能。

1
brew install --cask visual-studio-code

一些必备插件：

• Vim：为 VS Code 增加 Vim 快捷键支持
• Remote - SSH：支持通过 VS Code 直接远程服务器
• GitLens：Git 扩展
• Python：为 VS Code 提供 Python 开发支持
• Ruff：Rust 编写的 Python 代码格式化工具
• One Dark Pro：主题插件
• Material Icon Theme：文件和文件夹图标

编程语言

Python

macOS 自带 Python，如果想使用最新版本的 Python3，可通过 brew 安装：

1
brew install python3

当然更建议使用 pyenv 管理 Python 版本：

1
brew install pyenv
2
# ZSH 增加以下配置
3
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
4
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
5
echo 'eval "$(pyenv init -)"' >> ~/.zshrc

使用 Poetry 作为包管理工具：

1
brew install poetry
2

3
# 为 ohmyzsh 安装插件
4
mkdir $ZSH_CUSTOM/plugins/poetry
5
poetry completions zsh > $ZSH_CUSTOM/plugins/poetry/_poetry

在 ~/.zshrc -> plugins 中增加配置：

1
plugins(
2
  ...
3
  poetry
4
  )

最后更新配置

1
source ~/.zshrc

开始新项目

1
# 安装虚拟环境
2
pyenv install 3.12
3

4
# 创建项目≈
5
poetry new my-project
6
cd my-project
7

8
# 为当前项目指定版本
9
pyenv local 3.12
10

11
# 重新加载
12
source ~/.zshrc
13

14
# peotry 切换到对应版本
15
poetry env use python
16
# 安装依赖
17
poetry add fastapi

应用工具

预览增强

同样可以通过 Homebrew|brew 命令安装：

1
brew install qlcolorcode qlmarkdown

• qlcolorcode：可以预览一些常用代码文件，如 .py

• qlmarkdown: 预览 Markdown（支持渲染和源文件）

参考

• 访达预览插件：sindresorhus/quick-look-plugins