已全局安装SpecFlow.Plus.LivingDoc.CLI但执行livingdoc命令未识别如何解决

根因 #

dotnet全局工具的默认安装路径未被纳入系统PATH环境变量，终端无法定位到livingdoc的可执行文件。

操作步骤 #

• 确认dotnet全局工具安装路径
  Windows默认路径：%USERPROFILE%\.dotnet\tools
  macOS/Linux默认路径：~/.dotnet/tools
• 将上述路径添加到系统PATH环境变量

  Windows操作流程：

  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 找到用户变量或系统变量中的Path项，点击「编辑」
  3. 新建条目，粘贴dotnet全局工具路径，依次点击确定保存所有配置

  macOS/Linux操作流程：

  1. 打开shell对应的配置文件（常用的有~/.bashrc、~/.zshrc）
  2. 末尾添加一行：export PATH="$PATH:~/.dotnet/tools"
  3. 保存后执行source 对应的配置文件路径让配置即时生效

• 重启所有已打开的终端窗口，重新执行livingdoc test-assembly SpecFlowDemo.dll -t TestExecution.json即可正常调用

临时验证方案 #

如果不想修改环境变量，可直接用全路径调用命令，Windows下示例：
%USERPROFILE%\.dotnet\tools\livingdoc test-assembly SpecFlowDemo.dll -t TestExecution.json

排查校验 #

如果配置后仍报错，执行dotnet tool list --global，确认返回结果中存在SpecFlow.Plus.LivingDoc.CLI条目，排除安装失败的问题。

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