C# ASP.NET MVC项目添加迁移时提示dotnet-ef命令找不到如何解决

执行EF Core迁移命令时触发该错误，核心原因是dotnet CLI无法找到dotnet-ef命令工具，通常是工具未安装、环境变量未配置或命令拼写错误导致。

• 先校验命令拼写与执行路径
  标准添加迁移的命令格式为dotnet ef migrations add <自定义迁移名>，确认ef关键字没有拼写错误，子命令顺序没有写反。执行命令时终端的当前工作目录必须切换到ASP.NET MVC项目根目录（即存放.csproj文件的目录层级），不要在项目外层或其他无关目录执行指令。

• 安装dotnet-ef命令行工具
  根据使用场景选择全局安装或本地项目安装即可：

  • 全局安装（单开发环境推荐）
    执行以下命令完成全局安装，安装后所有目录都可直接调用dotnet ef指令：

    dotnet tool install --global dotnet-ef
    

    如果之前安装过旧版本出现异常，先执行卸载命令再重装：

    dotnet tool uninstall --global dotnet-ef
    

    安装完成后执行dotnet ef --version验证，正常返回版本号即说明安装成功。
    如果安装后仍提示找不到命令，需要将dotnet全局工具默认路径加入系统PATH环境变量：Windows系统默认路径为%USERPROFILE%\.dotnet\tools，macOS/Linux默认路径为$HOME/.dotnet/tools，添加完成后重启终端再重试。

  • 本地项目安装（团队协作推荐，统一工具版本）
    切换到项目根目录后依次执行以下命令：

    # 初始化本地工具清单（如果项目里已经有.config/dotnet-tools.json可以跳过这步）
    dotnet new tool-manifest
    # 安装本地dotnet-ef工具
    dotnet tool install dotnet-ef
    

    安装完成后在当前项目目录下即可正常调用dotnet ef相关命令。

• 校验项目依赖
  确认项目已经安装了和dotnet-ef大版本一致的EF Core相关NuGet包，必须安装的包包括Microsoft.EntityFrameworkCore、Microsoft.EntityFrameworkCore.Design，缺少Design包时也会导致迁移命令执行失败。如果项目里有多个类库分层，要将存放DbContext的启动项目设为命令执行的目标项目，或者在命令后加--startup-project <启动项目路径>参数指定启动项目。

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