将现有 .NET 应用迁移到 Windows Arm64,改动并不只是把构建目标从 x64 切换为 Arm64。代码中的架构假设、项目配置、依赖包以及原生组件,都可能成为迁移障碍。据 .NET Blog 2026 年 11 月 5 日发布的信息,GitHub Copilot upgrade agent 已提供 .NET Arm64 迁移场景,可用于识别阻塞项、制定迁移计划,并协助修改代码、依赖和项目配置。
具体会做哪些改动
这次升级的核心不是自动重写整套应用,而是把分散在代码库中的兼容性问题整理成可执行的迁移过程。upgrade agent 会先分析 .NET 项目及其依赖,识别与特定架构绑定的代码、不支持的组件和仅面向 x64 或 x86 的配置。随后,它会基于代码库生成迁移计划,并着手处理相关代码、依赖和项目设置;遇到需要人工判断的步骤时,再由开发者参与决定。
- 检查应用和依赖对 Arm64 的兼容性。
- 找出与 x64、x86 等特定架构绑定的假设。
- 创建面向当前代码库的迁移计划。
- 协助更新代码、依赖包和项目配置。
- 为 Windows Arm64 构建迁移后的组件。
- 在具备匹配硬件或 CI 运行程序时执行测试。
迁移前需要排查哪些阻塞项
显式指定 x64 的构建设置通常比较容易发现,更隐蔽的问题往往来自依赖关系。例如某个包表面上看与架构无关,但它间接使用的原生库可能没有提供 Arm64 版本。多个项目之间分散的平台假设,也可能在单独检查时不易暴露。
常见阻塞项包括:
- 代码或构建设置限定了特定处理器架构。
- 原生依赖没有提供 Arm64 二进制文件。
- 现有包或库缺少与 Arm64 兼容的版本。
- 平台相关假设分散在多个项目中。
- 运行环境或配置只面向 x64、x86。
适用场景与预期边界
这一场景适合需要把 Windows x64 或 x86 .NET 应用迁移到 Windows Arm64,并且希望在正式迁移前先完成系统性兼容性评估的团队。它尤其适合依赖关系复杂、架构限制散落在多个模块中的应用,因为升级代理能够先形成迁移清单和计划,让开发者按步骤审查并处理变更。
需要注意,微软将这项能力定位为可移植性和正确性改造,而不是 Arm64 专属的性能调优工具。成功构建只是重要检查点,不能替代运行时验证。代理即使完成了代码和配置更新,也仍应在 Windows Arm64 硬件或匹配的 CI 运行程序上测试实际行为,确认原生依赖、第三方组件及业务逻辑能够正常工作。
资料同时强调,Arm64 可能带来更低的计算成本和更高的基础设施效率,但这属于潜在收益,并非迁移后的必然结果。是否值得继续优化,应以应用在自身环境中的测量结果为依据。
迁移流程
开始迁移时,需要先安装 GitHub Copilot upgrade,在开发环境中选择升级代理,并明确提出将 .NET 应用迁移到 Windows Arm64 的目标。当代理询问场景时,选择 .NET Arm64 migration。随后可审查兼容性评估和迁移计划,让代理执行变更,同时逐步检查更新并完成需要人工介入的环节。最后,应在 Windows Arm64 硬件或 CI 运行程序上验证运行时行为,再决定是否投入进一步适配或性能优化。
资料来源:Modernize your .NET apps for Windows Arm64 with GitHub Copilot(2026-11-05)。
一起聊聊
留下你的想法,评论审核通过后展示。