.NET工具本地可运行，全局安装后无法启动的原因排查

我开发了一个面向.NET 6的dotnet工具，作为本地工具安装后可以正常运行，但安装为全局工具后，执行时提示未安装.NET运行时，尽管我已经安装了.NET 6和.NET 7的运行时。

问题核心原因 #

全局工具的宿主程序（apphost）由.NET 7 SDK构建，但工具目标框架为.NET 6。直接运行全局工具的可执行文件时，apphost会优先匹配自身版本对应的.NET 7运行时，由于探测逻辑与dotnet CLI存在差异，未能正确识别已安装的.NET 6运行时，导致报错。

解决方案 #

1. 使用.NET 6 SDK构建工具包 #

全局工具的apphost版本由构建时使用的SDK版本决定，需强制用.NET 6 SDK打包：

• 在项目根目录创建global.json文件，指定.NET 6 SDK版本：

  {
    "sdk": {
      "version": "6.0.404" // 替换为你已安装的.NET 6 SDK具体版本
    }
  }
  

• 重新执行dotnet pack命令打包工具，再安装全局版本。

2. 在csproj中显式指定运行时框架版本 #

通过配置RuntimeFrameworkVersion，让apphost明确知道要加载的.NET 6运行时版本：
修改你的csproj文件，添加如下配置：

<PropertyGroup>
  <OutputType>Exe</OutputType>
  <TargetFramework>net6.0</TargetFramework>
  <PackAsTool>true</PackAsTool>
  <ToolCommandName>mytool</ToolCommandName>
  <PackageId>$(MSBuildProjectName)</PackageId>
  <AssemblyName>mytool</AssemblyName>
  <RuntimeFrameworkVersion>6.0.12</RuntimeFrameworkVersion> <!-- 对应你已安装的.NET 6运行时版本 -->
</PropertyGroup>

重新打包并安装全局工具。

3. 验证工具包的runtimeconfig配置 #

解压工具的nupkg包，检查其中的mytool.runtimeconfig.json文件，确保以下配置正确：

{
  "runtimeOptions": {
    "tfm": "net6.0",
    "framework": {
      "name": "Microsoft.NETCore.App",
      "version": "6.0.12"
    }
  }
}

如果配置不符，重新构建打包。

4. 临时 workaround：通过dotnet CLI调用全局工具 #

如果暂时无法重新打包，可以直接通过dotnet调用工具的dll文件：

dotnet /home/user/.dotnet/tools/.store/my.package.mytool/<工具版本>/my.package.mytool/<工具版本>/tools/net6.0/any/mytool.dll

本地工具正常运行的原因 #

本地工具通过dotnet mytool或dotnet tool run mytool调用时，dotnet CLI会读取工具的目标框架信息，自动选择合适的.NET 6运行时来执行，规避了apphost的探测问题。

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