使用tfenv无法切换Terraform版本，寻求问题排查帮助

问题背景 #

执行tfenv相关命令显示版本已切换，但Terraform实际版本未改变：

$ tfenv version-name 
1.4.0

$ terraform --version
Terraform v1.2.7
on linux_amd64
+ provider registry.terraform.io/hashicorp/aws v4.48.0
+ provider registry.terraform.io/hashicorp/random v3.4.3
+ provider registry.terraform.io/hashicorp/template v2.2.0

Your version of Terraform is out of date! The latest version
is 1.5.7. You can update...

执行切换命令后提示成功，但版本依然不变：

$ tfenv use 1.4.0    
Switching default version to v1.4.0
Default version (when not overridden by .terraform-version or TFENV_TERRAFORM_VERSION) is now: 1.4.0

排查与解决步骤 #

• 检查tfenv的PATH优先级
  执行echo $PATH，确认tfenv的安装目录（通常是~/.tfenv/bin）位于系统原有Terraform路径（比如/usr/bin）之前。如果顺序不对，修改shell配置文件（~/.bashrc、~/.zshrc等），将export PATH="$HOME/.tfenv/bin:$PATH"放在PATH配置的最顶部，然后执行source ~/.bashrc（对应你的shell配置文件）生效。

• 检查本地版本覆盖项

  • 执行find . -name ".terraform-version"，查看当前目录或父目录是否存在该文件，若有则删除或修改文件内的版本号为1.4.0；
  • 执行echo $TFENV_TERRAFORM_VERSION，若输出非1.4.0的版本，执行unset TFENV_TERRAFORM_VERSION清除该环境变量。

• 验证tfenv版本安装与刷新

  • 执行tfenv list确认1.4.0已安装，若未安装则执行tfenv install 1.4.0；
  • 执行tfenv rehash刷新tfenv的版本链接，确保系统能正确识别切换后的版本。

• 重启shell会话
  修改PATH或配置后，执行exec $SHELL重新加载shell，或直接重启终端，再执行terraform --version验证版本是否切换成功。

内容的提问来源于stack exchange，提问作者David