需完成安装、验证与基础配置三环节：推荐用homebrew安装并验证版本；离线场景可手动下载二进制包并配置path；再初始化aws项目、通过环境变量注入密钥，最后清理多版本冲突。
如果您希望在 macOS 系统上快速部署 Terraform 并开始管理云基础设施，则需完成安装、验证与基础配置三个关键环节。以下是针对 macOS 平台的多种可行安装与配置路径：
一、使用 Homebrew 安装（推荐方式）
Homebrew 是 macOS 上最成熟稳定的包管理工具，能自动处理依赖、简化升级流程，并与 Terraform 官方维护策略高度协同。该方式适合大多数开发者及日常运维场景。
1、打开终端，执行命令安装 Homebrew（如尚未安装）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2、安装完成后，添加 HashiCorp 官方 tap 源：
brew tap hashicorp/tap
3、执行正式安装命令：
brew install hashicorp/tap/terraform
4、验证是否成功安装：
terraform version
5、若终端输出类似 Terraform v1.9.x 的版本号，则表示安装就绪。
二、手动下载安装（离线/版本锁定场景）
当需要指定特定旧版本、处于无网络环境或企业安全策略禁止使用第三方包管理器时，应采用官方预编译二进制包方式安装。此方式完全可控，避免 PATH 冲突与版本滞后问题。
1、访问 https://releases.hashicorp.com/terraform/，根据芯片类型选择对应包：
— M1/M2/M3 芯片请选择 darwin_arm64.zip
— Intel 芯片请选择 darwin_amd64.zip
2、下载完成后，在终端中解压并移动至系统路径：
unzip terraform_*.zip
sudo mv terraform /usr/local/bin/
3、赋予可执行权限：
sudo chmod +x /usr/local/bin/terraform
4、确认 /usr/local/bin 已在 PATH 中：
echo $PATH | grep -o "/usr/local/bin"
5、运行验证命令：
terraform --version
三、配置首个 Terraform 项目
安装仅是起点，必须完成初始化与 provider 加载才能实际操作云资源。本步骤以 AWS 为例，其他云厂商（如阿里云、腾讯云）原理一致，仅需替换 provider 块内容。
1、新建项目目录：
mkdir my-aws-infra && cd my-aws-infra
PyCharm 2026.2.0.1 Mac版提供 JetBrains 官方 2026.2.0.1 版本安装包，适合在macOS系统上进行 Python 项目开发、运行、调试和测试。
2、创建 main.tf 配置文件，写入以下内容：
terraform { required_providers { aws = { source = "hashicorp/aws" } } }
provider "aws" { region = "us-east-1" }
resource "aws_instance" "example" { ami = "ami-0c02fb55956c7d316" instance_type = "t2.micro" }
3、初始化工作目录（下载 AWS provider 插件）：
terraform init
4、检查语法与配置有效性：
terraform validate
5、预览将要创建的资源变更：
terraform plan
四、敏感信息与环境变量配置
Terraform 不允许在配置文件中硬编码密钥等敏感数据。必须通过操作系统级环境变量注入，确保凭据不落入版本控制系统且符合最小权限原则。
1、为 AWS 配置临时凭证（当前终端会话有效）：
export AWS_ACCESS_KEY_ID="AKIAxxx"
export AWS_SECRET_ACCESS_KEY="abc123xxx"
2、如需持久化，将上述两行追加至 shell 配置文件：
— Zsh 用户写入 ~/.zshrc
— Bash 用户写入 ~/.bash_profile
3、重载配置使生效：
source ~/.zshrc
4、验证凭证是否被识别：
terraform plan — 若提示 “No valid credential sources found”，说明环境变量未正确加载或拼写错误。
五、避免常见冲突的路径管理
同一系统中混用 Homebrew 与手动安装会导致 PATH 优先级混乱，可能调用到非预期版本的 terraform 可执行文件，进而引发 provider 兼容性失败或命令行为异常。
1、检查当前调用的二进制路径：
which terraform
2、列出所有可能存在的 terraform 文件位置：
find /usr -name "terraform" 2>/dev/null
find ~/ -name "terraform" 2>/dev/null
3、若发现多个路径存在（如 /opt/homebrew/bin/terraform 与 /usr/local/bin/terraform），请保留其一并删除其余副本。
4、清理 Homebrew 安装残留（如选用手动安装）：
brew uninstall hashicorp/tap/terraform
5、确认 PATH 中高优先级路径仅包含一个 terraform 实例：
echo $PATH
