dbt项目安装databricks插件后，dbt --version未显示该插件的问题

排查与修复步骤 #

1. 确认 Python 环境一致性 #

• 检查执行 dbt --version 的环境和安装插件的环境是否一致：
  • 执行 which dbt（Linux/macOS）或 where dbt（Windows）获取dbt的运行路径
  • 执行 pip --version查看当前pip对应的Python环境路径，对比两者是否匹配
  • 若路径不匹配，切换到安装插件的环境：比如激活虚拟环境source venv/bin/activate，或使用指定版本的Python执行安装，如python3 -m pip install dbt-databricks

2. 重装并验证插件安装 #

• 先卸载现有插件：

  pip uninstall dbt-databricks -y
  

• 安装与当前dbt-core版本兼容的dbt-databricks版本（需确保版本匹配，可参考dbt官方兼容说明）：

  pip install dbt-databricks==<对应兼容版本号>
  

• 安装完成后执行 pip list | grep dbt，确认dbt-databricks出现在输出列表中

3. 清理dbt缓存 #

• dbt可能因缓存问题无法识别新安装的插件，删除缓存目录后重试：
  • Linux/macOS：删除~/.dbt/目录
  • Windows：删除C:\Users\<你的用户名>\.dbt\目录
• 重新执行dbt --version查看插件是否显示

4. 验证适配器可用性 #

• 若以上步骤无效，可直接验证适配器是否能正常工作：
  • 初始化dbt项目：dbt init my_databricks_proj
  • 在profiles.yml中配置Databricks的连接信息
  • 执行dbt debug，若调试通过，说明适配器已安装成功，dbt --version的显示问题仅为环境或缓存异常导致

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