在 macOS 上用 Homebrew 安装 Terraform 是最稳妥省事的方式，需先安装 Homebrew（执行官方脚本），再添加 hashicorp/tap 仓库并安装 terraform，最后验证版本、路径及初始化项目以确认本地执行链完整可用。

在 macos 上用 homebrew 安装 terraform 是最稳妥、最省事的方式，尤其适合日常开发和持续迭代的 iac 工作流。它自动处理依赖、方便升级、路径也默认正确，基本装完就能跑。

确认并安装 Homebrew（如果还没装）

Homebrew 是 macOS 的基础包管理器，Terraform 官方推荐通过它安装。先检查是否已存在：

终端执行：which brew —— 如果没输出，说明未安装。

运行官方一键脚本安装（支持 Intel 和 Apple Silicon）：

• /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
• 安装完成后，建议运行 brew doctor 确认环境健康

添加 HashiCorp 仓库并安装 Terraform

HashiCorp 自 2023 年起将 Terraform 移入独立 tap，不再走主仓库。需显式添加：

macOS Local Voice

利用 macOS 原生能力实现本地语音识别与合成。通过 yap (Apple Speech.framework) 进行语音转文字，通过 say + ffmpeg 进行文字转语音。完全离线，无需 API 密钥。具备音质检测与智能选声功能。

下载

• brew tap hashicorp/tap
• brew install hashicorp/tap/terraform

这会安装最新稳定版（当前为 v1.9.x），同时自动把可执行文件链接到 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel），这两个路径通常已在你的 shell 的 PATH 中。

验证安装并检查环境

别跳过这步，很多问题其实卡在路径或权限上：

• 运行 terraform version —— 应看到类似 Terraform v1.9.4 的输出
• 运行 which terraform —— 确认路径是 Homebrew 管理的（如 /opt/homebrew/bin/terraform）
• 如果提示 command not found，检查 shell 配置文件（~/.zshrc 或 ~/.bash_profile）是否包含 Homebrew 的 PATH 声明，例如：export PATH="/opt/homebrew/bin:$PATH"

初始化第一个项目快速验证

装好只是起点，跑通最小工作流才算真正就位：

• 新建目录：mkdir tf-test && cd tf-test
• 创建 main.tf，写个空 provider（比如用 local）：

terraform {
  required_providers {
    local = {
      source  = "hashicorp/local"
      version = "~> 2.5"
    }
  }
}

provider "local" {}

resource "local_file" "test" {
  content  = "Hello from Terraform"
  filename = "${path.module}/hello.txt"
}

• 依次执行：terraform init → terraform plan → terraform apply -auto-approve
• 成功后，当前目录会生成 hello.txt 和 .terraform 目录，说明本地执行链完整可用