Harmes 是一款实用的开发工具，本文详细介绍在 MacBook 上安装 Harmes 的完整步骤，从零开始，手把手教学。
Harmes 是什么
Harmes 是一个运行在终端里的效率工具。与传统 GUI 工具不同，它能直接访问你的文件系统、执行命令、自动化工作流程，非常适合开发者和技术爱好者使用。
能做什么：
- 文件管理和批量操作
- 执行终端命令
- 工作流自动化
- 项目结构管理
- 快速搜索和过滤
---
第一步：检查系统要求
安装前确认你的 Mac 满足以下条件：
| 项目 | 要求 |
|---|---|
| 操作系统 | macOS 11.0 (Big Sur) 或更高 |
| 芯片 | Intel 或 Apple Silicon (M1/M2/M3/M4) |
| 内存 | 至少 4GB，推荐 8GB |
| 命令行工具 | Xcode Command Line Tools |
检查方法：
- 查看 macOS 版本：点击左上角苹果菜单 → 关于此 Mac
- 查看芯片类型：同一界面会显示「芯片」或「处理器」
- 检查 Xcode Command Line Tools：
xcode-select -p如果显示路径（如 /Applications/Xcode.app/Contents/Developer），说明已安装。
如果没有安装 Xcode Command Line Tools：
xcode-select --install弹出窗口提示时，点击「安装」，等待下载完成。
---
第二步：安装 Homebrew（推荐）
Homebrew 是 macOS 上最常用的包管理器，安装 Harmes 前建议先安装 Homebrew。
1. 检查是否已安装 Homebrew
打开终端，输入：
brew --version如果显示版本号（如 Homebrew 4.x.x），说明已安装，跳过此步。
2. 安装 Homebrew
如果没有，运行以下命令：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装过程中可能需要输入 Mac 密码，等待完成。
3. 验证 Homebrew
brew doctor显示 Your system is ready to brew. 表示安装正常。
---
第三步：安装 Harmes
方法一：Homebrew 安装（推荐）
brew install harms/tap/harmes验证安装：
harmest --version方法二：直接下载安装包
- 访问 Harmes 官网或 GitHub Release 页面
- 下载 macOS 安装包（.pkg 或 .zip 文件）
- 双击运行，按提示安装
方法三：源码安装
如果你熟悉编译流程：
git clone https://github.com/harmes/harmes.git
cd harmes
make install---
第四步：验证安装
安装完成后，验证 Harmes 是否正常工作：
1. 检查版本
harmest --version如果显示版本号，说明安装成功。
2. 查看帮助
harmest --help如果看到帮助信息，说明安装完成。
---
第五步：开始使用
基本用法
查看版本和状态：
harmest --version初始化配置：
harmest init查看可用命令：
harmest --help常用命令
| 命令 | 说明 |
|---|---|
harmest init | 初始化配置 |
harmest --help | 查看帮助信息 |
harmest --version | 查看版本 |
harmest status | 查看运行状态 |
首次使用建议
- 运行初始化
harmest init- 查看帮助文档
harmest --help- 测试基本功能
harmest status---
常见问题
问题一：安装失败，提示「curl: command not found」
原因：macOS 默认没有安装 curl 或路径问题
解决：先安装命令行工具：
xcode-select --install问题二：安装成功但运行报错「command not found」
原因：安装路径未添加到 PATH
解决：在 ~/.zshrc 中添加：
export PATH="/usr/local/bin:$PATH"然后运行 source ~/.zshrc
问题三：Homebrew 安装报错「Error: homebrew-core is a shallow clone」
解决：
git -C "$(brew --repo homebrew/core)" fetch --unshallow问题四：提示「Permission denied」
解决：给 CLI 添加执行权限：
chmod +x /usr/local/bin/harmest问题五：如何升级到最新版本？
Homebrew 安装（推荐）：
brew upgrade harms/tap/harmes问题六：如何卸载 Harmes
Homebrew 安装：
brew uninstall harms/tap/harmes手动删除：
rm -f /usr/local/bin/harmest
rm -rf ~/.config/harmes---
进阶配置
配置默认选项
在 ~/.config/harmes 目录创建配置文件 config.json：
{
"default_command": "status",
"verbose": false,
"theme": "default"
}设置别名（可选）
在 ~/.zshrc 中添加别名：
alias h="harmest"
alias hs="harmest status"然后运行 source ~/.zshrc。
---
总结
安装步骤回顾：
1. 检查系统要求（macOS 11.0+、Xcode Command Line Tools）
↓
2. 安装 Homebrew（如需要）
↓
3. 安装 Harmes
brew install harms/tap/harmes
↓
4. 验证安装
harmest --version
↓
5. 开始使用！推荐安装方式：Homebrew，一行命令搞定：
brew install harms/tap/harmes---
如果安装过程中遇到问题，欢迎在评论区留言。