第47章 Zed 在 macOS 上的安装与使用
Zed 主要在 macOS 上开发，因此 macOS 是拥有完整功能支持的一等平台。
安装 Zed
从下载页面下载 Zed。下载的是一个 .dmg 文件——打开后把 Zed 拖到应用程序文件夹即可。
预览版比稳定版提前约一周获得更新，可前往预览版发布页面下载。
安装后，Zed 会自动检查更新，有新版本时提醒你。
Homebrew
也可以用 Homebrew 安装 Zed：
brew install --cask zed
预览版则使用：
brew install --cask zed@preview
从源码构建
如需从源码构建 Zed，请参阅 macOS 开发文档。
系统要求
- macOS 10.15.7（Catalina）或更高版本
- Apple Silicon（M1/M2/M3/M4）或 Intel 处理器
Zed 使用 Metal 实现 GPU 加速渲染，所有受支持的 macOS 版本均支持该功能。
安装命令行工具
Zed 自带命令行工具，方便从终端打开文件和项目。安装方法：
- 打开 Zed
- 用
Cmd+Shift+P打开命令面板 - 运行 {#action cli::InstallCliBinary}
这会在 /usr/local/bin 中创建 zed 命令，之后就可以打开文件和文件夹：
zed . # 打开当前文件夹
zed file.txt # 打开一个文件
zed project/ file.txt # 同时打开文件夹和文件
所有可用选项详见 CLI 参考文档。
卸载
- 如果 Zed 正在运行，先退出
- 把 Zed 从应用程序文件夹拖到废纸篓
- 可选：删除设置和扩展：
rm -rf ~/.config/zed
rm -rf ~/Library/Application\ Support/Zed
rm -rf ~/Library/Caches/Zed
rm -rf ~/Library/Logs/Zed
rm -rf ~/Library/Saved\ Application\ State/dev.zed.Zed.savedState
如果安装过命令行工具，用以下命令删除：
rm /usr/local/bin/zed
故障排查
Zed 无法打开或显示“已损坏”警告
如果 macOS 报告 Zed 已损坏或无法打开，这通常是 Gatekeeper 导致的。请尝试以下操作：
- 在“应用程序”文件夹中右键点击（或按住 Control 键点击）Zed
- 从上下文菜单中选择“打开”
- 在弹出的对话框中点击“打开”
此举可让 macOS 信任该应用。
如果上述方法无效，请移除隔离属性：
xattr -cr /Applications/Zed.app
找不到 CLI 命令
如果安装后 zed 命令不可用：
- 检查
/usr/local/bin是否在你的 PATH 中 - 尝试通过命令面板中的 {#action cli::InstallCliBinary} 重新安装 CLI
- 打开一个新的终端窗口以重新加载 PATH
无法安装 CLI {#cant-install-cli}
{#action cli::InstallCliBinary} 需要在 /usr/local/bin 创建一个指向 zed 的符号链接，这需要管理员权限。如果你的 macOS 账号不在 admin 组中，Zed 将无法创建该符号链接，并会报告无法自动安装 CLI。
相反，你可以添加一个指向应用内部捆绑的 cli 二进制的别名。路径取决于 Zed 的安装位置：
# 默认安装（Zed 在 /Applications）
alias zed="/Applications/Zed.app/Contents/MacOS/cli"
# 用户安装（Zed 在 ~/Applications）
alias zed="$HOME/Applications/Zed.app/Contents/MacOS/cli"
# 预览版（Zed Preview 在 ~/Applications）
alias zed="$HOME/Applications/Zed Preview.app/Contents/MacOS/cli"
将与你安装类型匹配的那行代码添加到你的 shell 配置文件中。Zsh（现代 macOS 的默认 shell）使用 ~/.zshrc，Bash 使用 ~/.bashrc。
重启 shell 后，你就可以在终端中使用 zed 了：
zed . # 打开当前文件夹
zed file.txt # 打开文件
GPU 或渲染问题
Zed 使用 Metal 进行渲染。如果你遇到图形错误：
- 确保 macOS 已更新至最新版本
- 重启 Mac 以重置 GPU 状态
- 在“活动监视器”中检查其他应用造成的 GPU 压力
内存或 CPU 使用率高
如果 Zed 的资源使用量高于预期：
- 检查终端输出中的失控语言服务器（{#action zed::OpenLog}）
- 逐个禁用扩展以排查冲突
- 对于大型项目，建议通过项目设置将无关目录排除在索引之外
如需进一步帮助，请参阅故障排除指南或访问Zed Discord。
