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

references/

based on the routing table below.

.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

脚本

```
scripts/scan-dotnet-targets.py
```
-- Scan repository for .NET TFM and SDK version signals

```
scripts/scan-dotnet-targets.py
```
-- 扫描仓库中的.NET TFM和SDK版本标记

dotnet-tooling

Original

Translation

dotnet-tooling

dotnet-tooling

Overview

概述

Routing Table

路由表

Scope

覆盖范围

Out of scope

未覆盖范围

Scripts

脚本