# macOS 更新与卸载指南

本页面记录了 macOS（OS X）上 Construct 支持的更新和卸载流程。

最后验证时间：**2026年2月22日**。

## 1) 检查当前安装方式

```bash
which construct
construct --version
```

典型安装位置：

- Homebrew：`/opt/homebrew/bin/construct`（Apple Silicon）或 `/usr/local/bin/construct`（Intel）
- Cargo/引导安装/手动安装：`~/.cargo/bin/construct`

如果两者都存在，由你的 shell `PATH` 顺序决定运行哪一个。

## 2) 在 macOS 上更新

### A) Homebrew 安装

```bash
brew update
brew upgrade construct
construct --version
```

### B) 克隆 + 引导安装

在你本地的代码仓库目录中执行：

```bash
git pull --ff-only
./install.sh --prefer-prebuilt
construct --version
```

如果你想要仅源码更新：

```bash
git pull --ff-only
cargo install --path . --force --locked
construct --version
```

### C) 手动预编译二进制安装

使用最新的发布资产重新运行你的下载/安装流程，然后验证：

```bash
construct --version
```

## 3) 在 macOS 上卸载

### A) 首先停止并移除后台服务

这可以防止守护进程在二进制文件被移除后继续运行。

```bash
construct service stop || true
construct service uninstall || true
```

`service uninstall` 会移除的服务文件：

- `~/Library/LaunchAgents/com.construct.daemon.plist`

### B) 根据安装方式移除二进制文件

Homebrew：

```bash
brew uninstall construct
```

Cargo/引导安装/手动安装（`~/.cargo/bin/construct`）：

```bash
cargo uninstall construct || true
rm -f ~/.cargo/bin/construct
```

### C) 可选：移除本地运行时数据

仅当你想要完全清理配置、认证配置文件、日志和工作区状态时运行此命令。

```bash
rm -rf ~/.construct
```

## 4) 验证卸载完成

```bash
command -v construct || echo \"construct 二进制文件未找到\"
pgrep -fl construct || echo \"没有运行中的 construct 进程\"
```

如果 `pgrep` 仍然找到进程，手动停止它并重新检查：

```bash
pkill -f construct
```

## 相关文档

- [一键安装引导](one-click-bootstrap.zh-CN.md)
- [命令参考](../reference/cli/commands-reference.zh-CN.md)
- [故障排除](../ops/troubleshooting.zh-CN.md)
