推荐使用Homebrew安装(日常开发)或手动下载官方二进制包(生产环境),二者分别解决依赖管理和版本精确控制问题,再通过VSCode插件配置与基础验证确保IaC可用性。

如果您希望在 macOS 系统上部署 Terraform 以实现基础设施即代码(IaC)管理,但面临安装方式选择困难、版本冲突或执行权限异常等问题,则可能是由于安装路径不规范、芯片架构匹配错误或系统签名策略限制所致。以下是针对 macOS 的多种可靠安装方法:
一、使用 Homebrew 安装(推荐用于日常开发)
Homebrew 是 macOS 最主流的包管理工具,能自动处理依赖、简化升级流程,并与官方维护渠道同步,适合大多数开发者快速起步。
1、打开终端,执行命令安装 Homebrew(如已安装可跳过):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2、添加 HashiCorp 官方 tap 源:
brew tap hashicorp/tap
3、安装 Terraform:
brew install hashicorp/tap/terraform
4、验证安装结果:
terraform version
若输出类似 Terraform v1.9.x 的版本号,说明安装成功且已纳入 PATH。
二、手动安装官方二进制包(推荐用于生产环境或版本锁定场景)
该方式绕过包管理器,直接使用 HashiCorp 官网发布的预编译可执行文件,确保版本精确可控、无第三方依赖干扰,适用于 M1/M2/M3(ARM64)或 Intel(AMD64)芯片设备。
1、确认芯片架构:
arch
2、根据输出结果选择对应下载链接:
ARM64 设备访问 https://releases.hashicorp.com/terraform/latest/terraform_latest_darwin_arm64.zip
AMD64 设备访问 https://releases.hashicorp.com/terraform/latest/terraform_latest_darwin_amd64.zip
3、使用 curl 下载并解压(以 ARM64 为例):
curl -LO https://releases.hashicorp.com/terraform/latest/terraform_latest_darwin_arm64.zip
unzip terraform_latest_darwin_arm64.zip
4、将二进制文件移至系统路径并赋予权限:
sudo mv terraform /usr/local/bin/
sudo chmod +x /usr/local/bin/terraform
5、对 Apple Silicon 设备执行签名验证(避免“已损坏”提示):
codesign -dv --verbose=4 /usr/local/bin/terraform
三、通过 CloudShell 或远程终端安装(适用于无本地管理员权限场景)
当用户受限于企业策略无法修改 /usr/local/bin 或执行 sudo 命令时,可将 Terraform 二进制文件部署至用户级目录并显式配置 PATH,实现免 root 运行。
1、创建本地 bin 目录:
mkdir -p ~/bin
2、下载并解压二进制文件至该目录(以 ARM64 为例):
curl -LO https://releases.hashicorp.com/terraform/latest/terraform_latest_darwin_arm64.zip
unzip terraform_latest_darwin_arm64.zip -d ~/bin/
3、赋予执行权限:
chmod +x ~/bin/terraform
4、将 ~/bin 添加至当前 shell 配置文件:
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
5、验证是否生效:
which terraform
输出应为 /Users/yourname/bin/terraform。
四、VSCode 插件协同配置(保障 IaC 编写质量)
安装 Terraform CLI 后,需同步配置 VSCode 官方插件以支持语法校验、自动补全及格式化,避免因编辑器未识别 CLI 路径导致功能失效。
1、在 VSCode 扩展市场中搜索并安装 HashiCorp Terraform(发布者为 HashiCorp)
2、在终端中执行:
which terraform
3、复制返回路径(如 /usr/local/bin/terraform),进入 VSCode 设置界面,搜索 terraform.path,粘贴该路径
4、启用保存时自动格式化:
搜索 terraform.formatOnSave,设为 true
5、新建 .tf 文件测试高亮与提示是否正常响应。
五、安装后基础验证与项目初始化
完成任一安装方式后,必须验证 Terraform 是否能正确解析 HCL 配置并调用 provider,这是区分“安装成功”与“可用”的关键步骤。
1、新建项目目录:
mkdir my-first-iac && cd my-first-iac
2、创建最小化 main.tf:
echo 'terraform { required_providers { local = { source = "hashicorp/local" } } } provider "local" {} resource "local_file" "test" { filename = "test.txt" content = "IaC initialized." }' > main.tf
3、初始化工作区:
terraform init
4、预览变更计划:
terraform plan
5、执行本地资源创建:
terraform apply -auto-approve
若当前目录生成 test.txt 文件且内容为 IaC initialized.,表明 Terraform 已完整就绪。

















