CentralisedPackageConverter项目全解析.NET集中包管理CPM迁移神器首次完整揭秘【免费下载链接】CentralisedPackageConverterConverts a project to use Centralised Package Management项目地址: https://gitcode.com/gh_mirrors/ce/CentralisedPackageConverter大型 .NET 解决方案如何快速迁移到集中包管理CPMCentralisedPackageConverter 就是为这个问题而生的官方级转换神器。本文将首次完整揭秘这款开源工具从安装、使用到源码原理带新手 10 分钟上手把分散在各项目文件里的 NuGet 版本号一键收拢到Directory.Packages.props。什么是集中包管理CPM为什么要迁移在传统 .NET 项目中每个.csproj文件都会单独声明PackageReference的版本号。当一个解决方案包含几十上百个项目时你会遇到这些痛点版本不统一同一个包在不同项目里版本号五花八门升级麻烦升级某个包要逐个修改项目文件极易遗漏依赖混乱无法一眼看清全局用了哪些包、什么版本集中包管理CPMCentral Package Management是 NuGet 官方推出的解决方案把所有的包版本集中定义在根目录的Directory.Packages.props文件中各项目文件只声明包名不再写版本号。版本统一、升级省心、依赖一目了然。CentralisedPackageConverter 是什么CentralisedPackageConverter 是一个 .NET 全局工具dotnet tool支持C# 和 F# 项目能自动完成 CPM 迁移的两大核心工作✅ 扫描目录下所有项目文件收集全部带版本的包引用✅ 从项目文件中移除版本号把条目写入Directory.Packages.props它同样支持反向操作从集中式管理一键还原为各项目自带版本。这对大型仓库的迁移者来说等于省下了无数个枯燥的复制粘贴小时。第一步安装方法最快只需一条命令安装 CentralisedPackageConverter 非常简单在命令行执行dotnet tool install CentralisedPackageConverter --global安装完成后工具会以central-pkg-converter命令出现在你的终端中。整个项目围绕命令行工具构建入口逻辑集中在 Program.cs命令行参数定义在 CmdLineOptions.cs。第二步一键迁移命令最基础的用法是传入要转换的根目录central-pkg-converter /Users/you/SomeAwesomeProject工具会递归扫描该目录树下的所有.csproj、.vbproj、.fsproj、.props、.targets文件扫描逻辑见 DirectoryCrawler.cs自动完成迁移。执行前会列出待修改的文件并询问确认输入y后开始转换。 如果仓库在 GitCode 上可以先克隆git clone https://gitcode.com/gh_mirrors/ce/CentralisedPackageConverter再对仓库内的项目执行转换。第三步常用参数速查表下面这些参数是日常迁移最常用的建议收藏参数作用使用场景-r, --revert从 CPM 还原为项目内版本号迁移后想回退-d, --dry-run只读预览不改动磁盘先看效果再动手-f强制转换跳过确认提示自动化脚本/CI-m与已有 Directory 文件合并已有部分配置时-t, --transitive-pinning强制锁定传递依赖版本需要完全锁定依赖-v, --min-version多版本冲突时取最小值希望用较低版本-p, --ignore-prerelease忽略预发布版本只要稳定版-e, --encoding指定输出文件编码跨平台项目-l, --linewrap指定换行风格 lf/crlf/cr统一代码风格-x, --exclude-dirs排除匹配正则的目录跳过 bin/obj推荐组合用法迁移前先演练强烈建议新手第一步central-pkg-converter /path/to/project --dry-run迁移 忽略预发布 排除目录central-pkg-converter /path/to/project --ignore-prerelease --exclude-dirs ^\.|^bin$|^obj$还原回传统模式central-pkg-converter /path/to/project --revert核心工作原理它是怎么做到的理解原理能帮你更好地使用它。转换的核心在 PackageConverter.cs流程分四步扫描用 DirectoryCrawler.cs 递归找出所有项目文件收集解析每个PackageReference的Include和Version属性按条件分组存入内存字典去重遇到同名包多个版本时默认保留最高版本可通过-v改为最低版本版本比较策略封装在 Versioning.cs写入生成Directory.Packages.props并移除项目文件中的Version属性版本号解析使用 NuGet.Versioning 库见 PackageVersion.cs支持$(变量)形式、[固定版本]方括号语法等特殊格式。必须知道的 4 个注意事项⚠️浮动版本不支持CPM 本身不支持通配符或区间版本如1.*、[1.0,2.0)迁移时这类版本会被跳过需要手动处理。⚠️文件不完整时需要手动介入当项目中的版本缺失、无效如浮动版本或被忽略如预发布生成的Directory.Packages.props可能不完整需要手动补全。⚠️条件 ItemGroup 依赖如果ItemGroup上的Condition依赖具体项目文件转换结果可能不符合预期需要人工检查。⚠️先备份再转换虽然-m合并模式会自动备份旧文件为.bak但强烈建议在转换前用 Git 提交一次方便随时回滚。常见问题解答Q转换后项目还能正常编译吗A可以。CPM 是 NuGet 官方特性只要版本信息完整编译行为与之前一致。Q多个项目引用同一包的不同版本怎么办A工具默认取最高版本想取最低版本加-v想完全忽略预发布版加-p。Q只扫描部分目录可以吗A可以用-x配合正则排除默认已排除.开头目录、bin和obj。总结CentralisedPackageConverter 是 .NET 团队迁移集中包管理CPM时最省时的自动化工具一条命令安装、一条命令转换、支持预览回滚C#/F# 通吃。如果你正被几十个项目文件的版本管理折磨不妨立刻用--dry-run预览一下它的威力让版本管理从此集中、清晰、可控。【免费下载链接】CentralisedPackageConverterConverts a project to use Centralised Package Management项目地址: https://gitcode.com/gh_mirrors/ce/CentralisedPackageConverter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考