安装.NET全局工具dotnet-format时出现版本字符串无效错误

可能的版本来源 #

自动使用无效的0.0.1版本，通常是以下原因导致：

• 用户目录下的NuGet.config配置文件中，存在全局默认版本设置或针对dotnet-format的特定版本绑定，让CLI自动读取了这个无效版本。
• 本地dotnet工具缓存残留了错误的版本信息，或是环境变量中存在强制指定工具版本的配置项。
• 全新安装VS2022时，继承了用户目录下未清理的旧NuGet配置（VS全新安装不会自动覆盖用户目录的配置文件）。

解决步骤 #

• 检查并修正NuGet配置

  1. 打开用户目录下的NuGet.config文件：
     • Windows路径：C:\Users\<你的用户名>\AppData\Roaming\NuGet\NuGet.config
     • Mac/Linux路径：~/.nuget/NuGet/NuGet.config
  2. 查找是否包含<defaultVersion>0.0.1</defaultVersion>这类全局配置，或针对dotnet-format的版本约束，删除相关配置项后保存。

• 强制安装最新版本
  直接执行带版本参数的命令，绕过默认版本设置：

  dotnet tool install -g dotnet-format --version latest
  

• 清理工具缓存并重新安装

  1. 先卸载可能残留的无效工具（无安装记录也可执行）：

     dotnet tool uninstall -g dotnet-format
     

  2. 清理dotnet NuGet缓存：

     dotnet nuget locals http-cache --clear
     

  3. 重新执行安装命令。

• 检查环境变量
  查看系统或用户环境变量中是否存在DOTNET_TOOLS_VERSION等强制指定工具版本的变量，若有则删除，重启终端后重试安装。

• 验证VS2022的NuGet源配置
  打开VS2022，依次进入「工具」→「选项」→「NuGet包管理器」→「包源」，确保官方NuGet源（https://api.nuget.org/v3/index.json）处于启用状态，无异常自定义源强制指定版本。

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