SuperAPI AI 工具集

dotnet-tool-management

通用与其它

查看项目

更新于 10-16 07:24

技能介绍

用途:管理 .NET CLI 工具的消费端使用,包括全局工具与本地工具的安装、清单维护、版本固定、CI 集成和故障排查。基线为 .NET 8.0+;本地工具与工具清单自 .NET Core 3.0 起可用,RID 特定工具打包自 .NET 10 起可用。

主要能力:全局工具按用户安装,默认位于 Linux/macOS 的 $HOME/.dotnet/tools 或 Windows 的 %USERPROFILE%.dotnet\tools,可用 --tool-path 指定自定义目录(需自行管理 PATH)。本地工具通过 dotnet new tool-manifest 在仓库根创建 .config/dotnet-tools.json,用 dotnet tool install <package-id> 记录版本,dotnet tool run <command-name> 或 dotnet <command-name> 运行。支持 --version 指定精确版本、版本范围(如 "2.0.*")和预发布版本;清单记录解析后的精确版本,便于团队复现。

使用方式:团队一人创建清单并安装指定版本,提交 .config/dotnet-tools.json;其他成员克隆或拉取后运行 dotnet tool restore。CI 中在构建前执行 dotnet tool restore,再执行 dotnet build 等步骤;建议缓存 NuGet 包。更新用 dotnet tool update,卸载用 dotnet tool uninstall。

适用场景:项目构建、测试、开发工作流中的工具应优先使用本地工具与清单;全局工具适合个人效率工具或一次性工具。

限制与注意:CI 中不要全局安装项目工具,应使用本地清单与 restore;不要跳过 restore;不要遗漏提交清单;消费端安装时不要手动指定 RID 标志,CLI 会自动选择;注意包 ID 与命令名可能不同。工具创作与打包、分发策略、发布 CI/CD 不在本技能范围内。常见问题包括“工具已安装”“找不到清单”“安装后找不到工具”“CI 版本不匹配”等。