CentralisedPackageConverter源码解析从项目扫描到生成Directory.Packages.props的完整流程【免费下载链接】CentralisedPackageConverterConverts a project to use Centralised Package Management项目地址: https://gitcode.com/gh_mirrors/ce/CentralisedPackageConverterCentralisedPackageConverter 是一款开源的 .NET 全局工具它的核心功能是把大型解决方案一键迁移到集中包管理Central Package Management简称 CPM自动扫描所有项目文件、收集包引用版本最终生成统一的Directory.Packages.props配置文件。本文带你从源码层面拆解这条完整的转换流水线帮你彻底看懂这个包版本收编神器的内部工作原理以及如何用命令行参数驾驭它。为什么需要集中包管理在传统的 .NET 项目中每个.csproj文件里都写死了包版本PackageReference IncludeNewtonsoft.Json Version13.0.1 /一旦仓库里有几十上百个项目同一个包往往出现十几个不同的版本升级依赖时逐个文件修改既痛苦又容易遗漏。而集中包管理CPM的思路是把版本统一收进根目录的Directory.Packages.props项目文件里只保留包名。CentralisedPackageConverter 正是为消除这个迁移苦差事而生它同时支持 C#.csproj、VB.vbproj、F#.fsproj以及.props/.targets文件。一键安装与快速上手 工具以 dotnet 全局工具形式发布安装和运行都非常简单dotnet tool install CentralisedPackageConverter --global central-pkg-converter /path/to/YourSolution只需传入一个根目录工具就会完成扫描 → 收集 → 改写 → 生成的全过程。入口代码非常简洁核心调度逻辑全部在 Program.cs 和 PackageConverter.cs 中。第一步命令行参数如何被解析⚙️程序入口使用 CommandLineParser 库解析参数所有可用选项都定义在 CmdLineOptions.cs 中。除了必填的根目录参数外还有这些常用开关参数作用-r, --revert从集中管理回滚到项目文件内写版本-d, --dry-run只读演练不真正改动磁盘文件-f强制执行跳过确认提示-m与已有的Directory.Packages.props合并-t, --transitive-pinning开启CentralPackageTransitivePinningEnabledtrue-v, --min-version多版本冲突时选最小版本默认取最大-p, --ignore-prerelease忽略预发布版本-x, --exclude-dirs自定义排除目录的正则默认^\.|^bin$|^obj$值得注意默认排除规则会自动跳过.git这类隐藏目录以及bin、obj构建产物目录避免误伤。第二步DirectoryCrawler 如何扫描项目文件扫描逻辑封装在 DirectoryCrawler.cs 中。它利用 .NET 8 高性能的FileSystemEnumerable进行流式遍历通过两个关键谓词实现精准筛选ShouldIncludePredicate只收录扩展名在白名单中的文件.csproj/.vbproj/.fsproj/.props/.targetsShouldRecursePredicate目录名匹配排除正则时直接跳过整个子树不深入遍历。由于是基于正则而非简单的通配符你甚至可以用-x传入像^(node_modules|packages)$这样更复杂的排除规则实现高度定制化的扫描范围。第三步PackageConverter 的核心转换流程 真正的主角是 PackageConverter.cs 中的ProcessConversion方法整个转换流程可以分为四个清晰阶段阶段一预处理与安全检查工具先解析编码、换行符、版本策略等配置然后扫描出全部目标文件。除非你加了-f或-d否则它会列出将要修改的文件清单并等待你输入y确认——这个设计对新手非常友好避免误操作。阶段二逐项目收集版本信息ConvertProject方法负责处理每个项目文件用 LINQ to XML 读取所有PackageReference解析Version属性或子元素中的版本然后从项目文件中移除版本号同时把包名 版本登记到一个以条件Condition为分组键的内存字典中referencesByConditionThenName[条件] - { 包名 - 版本 }为什么按条件分组因为多目标框架项目里同一个包在不同ItemGroup Condition如net6.0/net48下可能版本不同集中管理时必须保留这种区分。对应的测试用例可见 PackageConverterTests.cs。阶段三生成 Directory.Packages.props收集完毕后WriteDirectoryPackagesConfig负责输出最终的配置文件结构如下Project PropertyGroup ManagePackageVersionsCentrallytrue/ManagePackageVersionsCentrally CentralPackageTransitivePinningEnabledfalse/CentralPackageTransitivePinningEnabled /PropertyGroup ItemGroup PackageVersion IncludeNewtonsoft.Json Version13.0.1 / /ItemGroup /Project如果目标位置已存在旧文件配合-m合并场景工具会先生成一份.bak备份再写入安全兜底。阶段四版本冲突裁决策略当多个项目对同一包声明了不同版本时Versioning.cs 负责裁决默认保留最大版本-v可改为保留最小版本-p会忽略所有预发布版本-c还能精细控制版本比较时考虑哪些部分默认 / 版本号 / 版本预发布 / 全量含元数据。版本对象本身的解析逻辑在 PackageVersion.cs它额外支持两类特殊值$(变量名)形式的 MSBuild 变量版本[1.2.3]方括号包裹的固定版本fixed version回滚时会原样还原。逆向操作一键回滚到项目内版本 ↩️集中管理不想要了怎么办-r参数提供了完美的后悔药RevertProject会读取Directory.Packages.props把每个包的版本重新写回各项目文件的PackageReference上最后删除集中的配置文件恢复原状。整个回滚同样保留条件分组语义多目标框架项目也能正确还原。细节亮点与注意事项 从源码中还能发现不少工程细节值得开发者学习格式可控Formatting.cs 支持通过-e指定文件编码如 utf-8、utf-16通过-l指定换行风格lf / crlf / cr跨平台团队协作时非常实用输出体验OutputExtensions.cs 基于 Spectre.Console 提供分级彩色输出信息 / 警告 / 错误 / 跟踪运行过程一目了然测试完备项目自带 PackageConverterTests.cs、DirectoryCrawlerTests.cs 等测试套件覆盖了命名空间处理、大小写属性、条件分组、编码字节级校验等边界场景已知限制CPM 本身不支持浮动版本如3.0.*、区间版本这类引用在转换时会被跳过或需要手动处理文档在 README.md 中有详细说明。总结一条流水线看懂整个工具 回顾整条链路Program.cs 解析参数 → DirectoryCrawler 递归扫描 → PackageConverter 逐文件移除版本并收集 → Versioning 裁决冲突版本 → 生成 Directory.Packages.props。五个模块各司其职、环环相扣代码量不大却把迁移工作流打磨得相当完整。无论你是想直接用它拯救版本地狱项目还是想学习如何用 C# 构建一个安全可靠的批量文件处理工具CentralisedPackageConverter 都是绝佳的参考范本。现在就 clone 下来跑一次-d演练亲眼看看它如何快速生成那份清爽的Directory.Packages.props吧【免费下载链接】CentralisedPackageConverterConverts a project to use Centralised Package Management项目地址: https://gitcode.com/gh_mirrors/ce/CentralisedPackageConverter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
CentralisedPackageConverter源码解析从项目扫描到生成Directory.Packages.props的完整流程【免费下载链接】CentralisedPackageConverterConverts a project to use Centralised Package Management项目地址: https://gitcode.com/gh_mirrors/ce/CentralisedPackageConverterCentralisedPackageConverter 是一款开源的 .NET 全局工具它的核心功能是把大型解决方案一键迁移到集中包管理Central Package Management简称 CPM自动扫描所有项目文件、收集包引用版本最终生成统一的Directory.Packages.props配置文件。本文带你从源码层面拆解这条完整的转换流水线帮你彻底看懂这个包版本收编神器的内部工作原理以及如何用命令行参数驾驭它。为什么需要集中包管理在传统的 .NET 项目中每个.csproj文件里都写死了包版本PackageReference IncludeNewtonsoft.Json Version13.0.1 /一旦仓库里有几十上百个项目同一个包往往出现十几个不同的版本升级依赖时逐个文件修改既痛苦又容易遗漏。而集中包管理CPM的思路是把版本统一收进根目录的Directory.Packages.props项目文件里只保留包名。CentralisedPackageConverter 正是为消除这个迁移苦差事而生它同时支持 C#.csproj、VB.vbproj、F#.fsproj以及.props/.targets文件。一键安装与快速上手 工具以 dotnet 全局工具形式发布安装和运行都非常简单dotnet tool install CentralisedPackageConverter --global central-pkg-converter /path/to/YourSolution只需传入一个根目录工具就会完成扫描 → 收集 → 改写 → 生成的全过程。入口代码非常简洁核心调度逻辑全部在 Program.cs 和 PackageConverter.cs 中。第一步命令行参数如何被解析⚙️程序入口使用 CommandLineParser 库解析参数所有可用选项都定义在 CmdLineOptions.cs 中。除了必填的根目录参数外还有这些常用开关参数作用-r, --revert从集中管理回滚到项目文件内写版本-d, --dry-run只读演练不真正改动磁盘文件-f强制执行跳过确认提示-m与已有的Directory.Packages.props合并-t, --transitive-pinning开启CentralPackageTransitivePinningEnabledtrue-v, --min-version多版本冲突时选最小版本默认取最大-p, --ignore-prerelease忽略预发布版本-x, --exclude-dirs自定义排除目录的正则默认^\.|^bin$|^obj$值得注意默认排除规则会自动跳过.git这类隐藏目录以及bin、obj构建产物目录避免误伤。第二步DirectoryCrawler 如何扫描项目文件扫描逻辑封装在 DirectoryCrawler.cs 中。它利用 .NET 8 高性能的FileSystemEnumerable进行流式遍历通过两个关键谓词实现精准筛选ShouldIncludePredicate只收录扩展名在白名单中的文件.csproj/.vbproj/.fsproj/.props/.targetsShouldRecursePredicate目录名匹配排除正则时直接跳过整个子树不深入遍历。由于是基于正则而非简单的通配符你甚至可以用-x传入像^(node_modules|packages)$这样更复杂的排除规则实现高度定制化的扫描范围。第三步PackageConverter 的核心转换流程 真正的主角是 PackageConverter.cs 中的ProcessConversion方法整个转换流程可以分为四个清晰阶段阶段一预处理与安全检查工具先解析编码、换行符、版本策略等配置然后扫描出全部目标文件。除非你加了-f或-d否则它会列出将要修改的文件清单并等待你输入y确认——这个设计对新手非常友好避免误操作。阶段二逐项目收集版本信息ConvertProject方法负责处理每个项目文件用 LINQ to XML 读取所有PackageReference解析Version属性或子元素中的版本然后从项目文件中移除版本号同时把包名 版本登记到一个以条件Condition为分组键的内存字典中referencesByConditionThenName[条件] - { 包名 - 版本 }为什么按条件分组因为多目标框架项目里同一个包在不同ItemGroup Condition如net6.0/net48下可能版本不同集中管理时必须保留这种区分。对应的测试用例可见 PackageConverterTests.cs。阶段三生成 Directory.Packages.props收集完毕后WriteDirectoryPackagesConfig负责输出最终的配置文件结构如下Project PropertyGroup ManagePackageVersionsCentrallytrue/ManagePackageVersionsCentrally CentralPackageTransitivePinningEnabledfalse/CentralPackageTransitivePinningEnabled /PropertyGroup ItemGroup PackageVersion IncludeNewtonsoft.Json Version13.0.1 / /ItemGroup /Project如果目标位置已存在旧文件配合-m合并场景工具会先生成一份.bak备份再写入安全兜底。阶段四版本冲突裁决策略当多个项目对同一包声明了不同版本时Versioning.cs 负责裁决默认保留最大版本-v可改为保留最小版本-p会忽略所有预发布版本-c还能精细控制版本比较时考虑哪些部分默认 / 版本号 / 版本预发布 / 全量含元数据。版本对象本身的解析逻辑在 PackageVersion.cs它额外支持两类特殊值$(变量名)形式的 MSBuild 变量版本[1.2.3]方括号包裹的固定版本fixed version回滚时会原样还原。逆向操作一键回滚到项目内版本 ↩️集中管理不想要了怎么办-r参数提供了完美的后悔药RevertProject会读取Directory.Packages.props把每个包的版本重新写回各项目文件的PackageReference上最后删除集中的配置文件恢复原状。整个回滚同样保留条件分组语义多目标框架项目也能正确还原。细节亮点与注意事项 从源码中还能发现不少工程细节值得开发者学习格式可控Formatting.cs 支持通过-e指定文件编码如 utf-8、utf-16通过-l指定换行风格lf / crlf / cr跨平台团队协作时非常实用输出体验OutputExtensions.cs 基于 Spectre.Console 提供分级彩色输出信息 / 警告 / 错误 / 跟踪运行过程一目了然测试完备项目自带 PackageConverterTests.cs、DirectoryCrawlerTests.cs 等测试套件覆盖了命名空间处理、大小写属性、条件分组、编码字节级校验等边界场景已知限制CPM 本身不支持浮动版本如3.0.*、区间版本这类引用在转换时会被跳过或需要手动处理文档在 README.md 中有详细说明。总结一条流水线看懂整个工具 回顾整条链路Program.cs 解析参数 → DirectoryCrawler 递归扫描 → PackageConverter 逐文件移除版本并收集 → Versioning 裁决冲突版本 → 生成 Directory.Packages.props。五个模块各司其职、环环相扣代码量不大却把迁移工作流打磨得相当完整。无论你是想直接用它拯救版本地狱项目还是想学习如何用 C# 构建一个安全可靠的批量文件处理工具CentralisedPackageConverter 都是绝佳的参考范本。现在就 clone 下来跑一次-d演练亲眼看看它如何快速生成那份清爽的Directory.Packages.props吧【免费下载链接】CentralisedPackageConverterConverts a project to use Centralised Package Management项目地址: https://gitcode.com/gh_mirrors/ce/CentralisedPackageConverter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
