本地工具

运维部署 社区

技能解读

当前原文的自动摘译,尚未人工审校。

何时使用此技能

在以下情况下使用此技能: 在整个开发团队中设置一致的工具 确保 CI/CD 管道使用与本地开发相同的工具版本 管理特定于项目的 CLI 工具(docfx、incrementalist、dotnet-ef 等) 避免项目之间的全局工具版本冲突

什么是本地工具?

本地工具是按存储库而不是全局安装和版本控制的 .NET CLI 工具。它们在.config/dotnet-tools.json中定义并用dotnet tool restore恢复。

本地工具与全局工具

方面 · 全局工具 · 本地工具安装 · dotnet tool install -g · dotnet tool restore 范围 · 机器范围 · 每个存储库 版本控制 · 手动 · 在 .config/dotnet-tools.json CI/CD 中 · 必须安装每个工具 · 单个恢复命令

初始化清单

这将创建:

领域

字段 · 描述 version · 清单架构版本(始终为 1) isRoot · 将其标记为根清单(防止搜索父目录) tools · 工具配置字典 tools.<name>.version · 要安装的确切版本

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
运维部署
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@Aaronontheweb · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
Linux
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

输出预览 dotnet-local-tools.preview
{
  "version": 1,
  "isRoot": true,
  "tools": {
    "docfx": {
      "version": "2.78.3",
      "commands": ["docfx"],
      "rollForward": false
    },
    "dotnet-ef": {
      "version": "9.0.0",
      "commands": ["dotnet-ef"],
      "rollForward": false
    },
    "dotnet-reportgenerator-globaltool": {
      "version": "5.4.1",
      "commands": ["reportgenerator"],
      "rollForward": false
    },
    "csharpier": {
      "version": "0.30.3",
      "commands": ["dotnet-csharpier"],
      "rollForward": false
    },
    "incrementalist.cmd": {
      "version": "1.2.0",
      "commands": ["incrementalist"],
      "rollForward": false
    }
  }
}

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。