Windows系统VS终端运行dbt命令提示「dbt未被识别」故障求助

核心问题原因 #

Mac系统默认会将Python的Scripts目录加入全局PATH，而Windows系统默认不会配置该路径，因此即使pip安装dbt成功，终端也找不到dbt的可执行文件。

排查解决步骤 #

• 第一步：确认dbt安装路径
  打开PowerShell执行pip show dbt-bigquery，找到返回结果中的Location字段，例如返回值为C:\Users\你的用户名\AppData\Roaming\Python\Python310\site-packages，则dbt的可执行文件在同级的Scripts目录下，即C:\Users\你的用户名\AppData\Roaming\Python\Python310\Scripts，进入该目录确认存在dbt.exe文件。
• 第二步：添加路径到系统环境变量
  右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，在用户变量或系统变量列表中找到Path，点击编辑后新建条目，将上一步找到的Scripts目录完整路径粘贴进去，依次点击所有弹窗的确定按钮保存配置。
• 第三步：验证配置生效
  完全关闭所有已打开的终端窗口、VS Code软件，重新打开VS Code终端，执行dbt --version，正常返回版本信息即配置成功。

依赖缺失问题处理 #

如果安装时提示依赖缺失，按以下步骤重装即可：

1. 执行pip uninstall dbt-core dbt-bigquery -y卸载现有dbt相关组件
2. 执行pip install --upgrade pip升级pip到最新版本
3. 执行pip install dbt-bigquery --force-reinstall强制重新安装dbt-bigquery及匹配的依赖组件

注意：修改环境变量后必须完全关闭VS Code再重启，VS Code内置终端会缓存旧的环境变量配置，仅重启终端无法生效。

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