在Ubuntu 24.01运行EF Core迁移遇dotnet-ef未找到错误求助

问题原因 #

报错提示找不到dotnet-ef命令，核心原因是未安装EF Core全局工具，或者工具安装路径未加入当前用户的PATH环境变量（即使dotnet主目录已加入PATH，全局工具的独立路径可能未配置）。

解决步骤 #

• 检查EF Core全局工具是否已安装
  执行以下命令查看已安装的全局工具：

  dotnet tool list --global
  

  若输出中没有Microsoft.EntityFrameworkCore.Tools，说明未安装。

• 安装EF Core全局工具
  执行安装命令：

  dotnet tool install --global dotnet-ef
  

• 确认工具安装路径已加入PATH
  dotnet全局工具默认安装路径：

  • 普通用户：~/.dotnet/tools
  • root用户：/root/.dotnet/tools

  执行echo $PATH查看当前PATH，若上述路径不在其中，手动添加：

  • 普通用户：编辑~/.bashrc或~/.zshrc，添加一行：

    export PATH="$PATH:$HOME/.dotnet/tools"
    

    执行source ~/.bashrc（或对应shell配置文件）使更改生效。
  • root用户：编辑/root/.bashrc，添加同样内容后执行source /root/.bashrc生效。

• 验证修复效果
  执行以下命令确认工具可用：

  dotnet ef --version
  

  若能正常显示版本号，再重新运行你的迁移命令：

  dotnet ef database update --project AuthenticationService --startup-project AuthenticationService
  

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