dotnet-tooling
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinesedotnet-tooling
dotnet-tooling
Overview
概述
.NET project setup, build systems, performance, CLI apps, and developer tooling. This consolidated skill spans 32 topic areas. Load the appropriate companion file from based on the routing table below.
references/.NET项目设置、构建系统、性能优化、CLI应用及开发工具链。该整合技能涵盖32个主题领域。请根据下方的路由表，从目录加载对应的配套文件。
references/Routing Table
路由表
| Topic | Keywords | Description | Companion File |
|---|---|---|---|
| Project structure | solution, .slnx, CPM, analyzers | .slnx, Directory.Build.props, CPM, analyzers | references/project-structure.md |
| Scaffold project | dotnet new, CPM, SourceLink, editorconfig | dotnet new with CPM, analyzers, editorconfig, SourceLink | references/scaffold-project.md |
| Csproj reading | PropertyGroup, ItemGroup, CPM, props | SDK-style .csproj, PropertyGroup, ItemGroup, CPM | references/csproj-reading.md |
| MSBuild authoring | targets, props, conditions, Directory.Build | Targets, props, conditions, Directory.Build patterns | references/msbuild-authoring.md |
| MSBuild tasks | ITask, ToolTask, inline tasks, UsingTask | ITask, ToolTask, IIncrementalTask, inline tasks | references/msbuild-tasks.md |
| Build analysis | MSBuild output, NuGet errors, analyzer warnings | MSBuild output, NuGet errors, analyzer warnings | references/build-analysis.md |
| Build optimization | slow builds, binary logs, parallel, restore | Slow builds, binary logs, parallel, restore | references/build-optimization.md |
| Artifacts output | UseArtifactsOutput, ArtifactsPath, CI/Docker | UseArtifactsOutput, ArtifactsPath, CI/Docker impact | references/artifacts-output.md |
| Multi-targeting | multiple TFMs, polyfills, conditional compilation | Multiple TFMs, PolySharp, conditional compilation | references/multi-targeting.md |
| Performance patterns | Span, ArrayPool, ref struct, sealed, stackalloc | Span, ArrayPool, ref struct, sealed, stackalloc | references/performance-patterns.md |
| Profiling | dotnet-counters, dotnet-trace, flame graphs | dotnet-counters, dotnet-trace, dotnet-dump, flame graphs | references/profiling.md |
| Native AOT | PublishAot, ILLink, P/Invoke, size optimization | PublishAot, ILLink descriptors, P/Invoke, size optimization | references/native-aot.md |
| AOT architecture | source gen, AOT-safe DI, serialization | Source gen over reflection, AOT-safe DI, factories | references/aot-architecture.md |
| Trimming | annotations, ILLink, IL2xxx warnings, IsTrimmable | Annotations, ILLink, IL2xxx warnings, IsTrimmable | references/trimming.md |
| GC/memory | GC modes, LOH/POH, Span/Memory, ArrayPool | GC modes, LOH/POH, Gen0/1/2, Span/Memory, ArrayPool | references/gc-memory.md |
| CLI architecture | command/handler/service, clig.dev, exit codes | Command/handler/service, clig.dev, exit codes | references/cli-architecture.md |
| System.CommandLine | RootCommand, Option<T>, SetAction, parsing | System.CommandLine 2.0, RootCommand, Option<T> | references/system-commandline.md |
| Spectre.Console | tables, trees, progress, prompts, live displays | Tables, trees, progress, prompts, live displays | references/spectre-console.md |
| Terminal.Gui | views, layout, menus, dialogs, bindings, themes | Terminal.Gui v2, views, layout, menus, dialogs | references/terminal-gui.md |
| CLI distribution | AOT vs framework-dependent, RID matrix | AOT vs framework-dependent, RID matrix, single-file | references/cli-distribution.md |
| CLI packaging | Homebrew, apt/deb, winget, Scoop, Chocolatey | Homebrew, apt/deb, winget, Scoop, Chocolatey | references/cli-packaging.md |
| CLI release pipeline | GHA build matrix, artifact staging, checksums | GHA build matrix, artifact staging, checksums | references/cli-release-pipeline.md |
| Documentation strategy | Starlight, Docusaurus, DocFX decision tree | Starlight, Docusaurus, DocFX decision tree | references/documentation-strategy.md |
| XML docs | tags, inheritdoc, GenerateDocumentationFile | XML doc comments, inheritdoc, warning suppression | references/xml-docs.md |
| Tool management | global, local, manifests, restore, pinning | Global/local tools, manifests, restore, pinning | references/tool-management.md |
| Version detection | TFM/SDK from .csproj, global.json | TFM/SDK from .csproj, global.json, Directory.Build | references/version-detection.md |
| Version upgrade | LTS-to-LTS, staged, preview, upgrade paths | LTS-to-LTS, staged through STS, preview paths | references/version-upgrade.md |
| Solution navigation | entry points, .sln/.slnx, dependency graphs | Entry points, .sln/.slnx, dependency graphs | references/solution-navigation.md |
| Project analysis | solution layout, build config analysis | Solution layout, build config, .csproj analysis | references/project-analysis.md |
| Modernize | outdated TFMs, deprecated packages, patterns | Outdated TFMs, deprecated packages, superseded patterns | references/modernize.md |
| Add analyzers | nullable, trimming, AOT compat, severity config | Nullable, trimming, AOT compat analyzers, severity | references/add-analyzers.md |
| Mermaid diagrams | architecture, sequence, class, ER, flowcharts | Architecture, sequence, class, deployment, ER diagrams | references/mermaid-diagrams.md |
| 主题 | 关键词 | 描述 | 配套文件 |
|---|---|---|---|
| 项目结构 | solution, .slnx, CPM, analyzers | .slnx、Directory.Build.props、CPM、代码分析器 | references/project-structure.md |
| 项目脚手架 | dotnet new, CPM, SourceLink, editorconfig | 结合CPM、代码分析器、editorconfig、SourceLink使用dotnet new | references/scaffold-project.md |
| Csproj文件读取 | PropertyGroup, ItemGroup, CPM, props | SDK风格的.csproj、PropertyGroupItemGroup、CPM | references/csproj-reading.md |
| MSBuild编写 | targets, props, conditions, Directory.Build | Targets、props、条件判断、Directory.Build模式 | references/msbuild-authoring.md |
| MSBuild任务 | ITask, ToolTask, inline tasks, UsingTask | ITask、ToolTask、IIncrementalTask、内联任务 | references/msbuild-tasks.md |
| 构建分析 | MSBuild output, NuGet errors, analyzer warnings | MSBuild输出、NuGet错误代码分析器警告 | references/build-analysis.md |
| 构建优化 | slow builds, binary logs, parallel, restore | 构建缓慢问题、二进制日志、并行构建、还原操作 | references/build-optimization.md |
| 产物输出 | UseArtifactsOutput, ArtifactsPath, CI/Docker | UseArtifactsOutput、ArtifactsPath、对CI/Docker的影响 | references/artifacts-output.md |
| 多目标框架 | multiple TFMs, polyfills, conditional compilation | 多TFMs、PolySharp、条件编译 | references/multi-targeting.md |
| 性能模式 | Span, ArrayPool, ref struct, sealed, stackalloc | Span、ArrayPool、ref struct、sealed、stackalloc | references/performance-patterns.md |
| 性能分析 | dotnet-counters, dotnet-trace, flame graphs | dotnet-counters、dotnet-trace、dotnet-dump、火焰图 | references/profiling.md |
| Native AOT | PublishAot, ILLink, P/Invoke, size optimization | PublishAot、ILLink描述符、P/Invoke、体积优化 | references/native-aot.md |
| AOT架构 | source gen, AOT-safe DI, serialization | 优先使用源代码生成而非反射、AOT兼容的DI、工厂模式 | references/aot-architecture.md |
| 代码裁剪 | annotations, ILLink, IL2xxx warnings, IsTrimmable | 注解、ILLink、IL2xxx警告、IsTrimmable | references/trimming.md |
| GC/内存 | GC modes, LOH/POH, Span/Memory, ArrayPool | GC模式、LOH/POH、Gen0/1/2、Span/Memory、ArrayPool | references/gc-memory.md |
| CLI架构 | command/handler/service, clig.dev, exit codes | 命令/处理器/服务模式、clig.dev、退出码 | references/cli-architecture.md |
| System.CommandLine | RootCommand, Option<T>, SetAction, parsing | System.CommandLine 2.0、RootCommand、Option<T> | references/system-commandline.md |
| Spectre.Console | tables, trees, progress, prompts, live displays | 表格、树形结构、进度条、提示框、实时显示 | references/spectre-console.md |
| Terminal.Gui | views, layout, menus, dialogs, bindings, themes | Terminal.Gui v2、视图、布局、菜单、对话框 | references/terminal-gui.md |
| CLI分发 | AOT vs framework-dependent, RID matrix | AOT与框架依赖模式对比、RID矩阵、单文件发布 | references/cli-distribution.md |
| CLI打包 | Homebrew, apt/deb, winget, Scoop, Chocolatey | Homebrew、apt/deb、winget、Scoop、Chocolatey | references/cli-packaging.md |
| CLI发布流水线 | GHA build matrix, artifact staging, checksums | GHA构建矩阵、产物暂存、校验和 | references/cli-release-pipeline.md |
| 文档策略 | Starlight, Docusaurus, DocFX decision tree | Starlight、Docusaurus、DocFX选型决策树 | references/documentation-strategy.md |
| XML文档 | tags, inheritdoc, GenerateDocumentationFile | XML文档注释、inheritdoc、警告抑制 | references/xml-docs.md |
| 工具管理 | global, local, manifests, restore, pinning | 全局/本地工具、清单、还原、版本固定 | references/tool-management.md |
| 版本检测 | TFM/SDK from .csproj, global.json | 从.csproj、global.json、Directory.Build获取TFM/SDK版本 | references/version-detection.md |
| 版本升级 | LTS-to-LTS, staged, preview, upgrade paths | LTS到LTS升级、通过STS分阶段升级、预览版升级路径 | references/version-upgrade.md |
| 解决方案导航 | entry points, .sln/.slnx, dependency graphs | 入口点、.sln/.slnx、依赖图 | references/solution-navigation.md |
| 项目分析 | solution layout, build config analysis | 解决方案布局、构建配置、.csproj分析 | references/project-analysis.md |
| 现代化改造 | outdated TFMs, deprecated packages, patterns | 过时的TFMs、已弃用的包、被取代的模式 | references/modernize.md |
| 添加代码分析器 | nullable, trimming, AOT compat, severity config | 可空引用、代码裁剪、AOT兼容分析器、Severity配置 | references/add-analyzers.md |
| Mermaid图表 | architecture, sequence, class, ER, flowcharts | 架构图、时序图、类图、部署图、ER图 | references/mermaid-diagrams.md |
Scope
覆盖范围
- Solution structure and project scaffolding
- MSBuild authoring and build optimization
- Performance patterns and profiling
- Native AOT, trimming, and GC tuning
- CLI app development (System.CommandLine, Spectre.Console, Terminal.Gui)
- Documentation generation (DocFX, XML docs)
- Tool management and version detection/upgrade
- Solution navigation and project analysis
- Code modernization and analyzer configuration
- Mermaid diagram generation
- 解决方案结构与项目脚手架
- MSBuild编写与构建优化
- 性能模式与性能分析
- Native AOT、代码裁剪与GC调优
- CLI应用开发（System.CommandLine、Spectre.Console、Terminal.Gui）
- 文档生成（DocFX、XML文档）
- 工具管理与版本检测/升级
- 解决方案导航与项目分析
- 代码现代化改造与分析器配置
- Mermaid图表生成
Out of scope
未覆盖范围
- Web API patterns -> [skill:dotnet-api]
- Test authoring -> [skill:dotnet-testing]
- CI/CD pipelines -> [skill:dotnet-devops]
- C# language patterns -> [skill:dotnet-csharp]
- UI framework development -> [skill:dotnet-ui]
- WinDbg debugging -> [skill:dotnet-debugging]
- Web API模式 -> [skill:dotnet-api]
- 测试编写 -> [skill:dotnet-testing]
- CI/CD流水线 -> [skill:dotnet-devops]
- C#语言模式 -> [skill:dotnet-csharp]
- UI框架开发 -> [skill:dotnet-ui]
- WinDbg调试 -> [skill:dotnet-debugging]
Scripts
脚本
- -- Scan repository for .NET TFM and SDK version signals
scripts/scan-dotnet-targets.py
- -- 扫描仓库中的.NET TFM和SDK版本标记
scripts/scan-dotnet-targets.py