> 想尽快升级到 .NET 10，但 Pomelo 还没支持 EF Core 10？本文介绍一个兼容方案——Microting.EntityFrameworkCore.MySql，以及如何平滑切换。

---

## 一、背景：.NET 10 已来，Pomelo 还没跟上

2025年11月，微软发布了 .NET 10 LTS 版本，带来了 C# 14、EF Core 10、性能优化等一系列新特性，将获得3年官方支持。对于希望尽早升级的团队来说，这是一个值得期待的版本。

但对于使用 MySQL/MariaDB 的 .NET 项目，有一个现实问题：EF Core 生态中最主流的 MySQL 提供程序 **Pomelo.EntityFrameworkCore.MySql** 尚未推出支持 EF Core 10 的稳定版本。

Pomelo 是微软官方推荐的 MySQL 提供程序之一，NuGet 下载量超过1.26亿次，被近千个开源项目依赖。作为社区驱动的开源项目，它由志愿者维护，版本发布节奏通常比 .NET 官方慢半拍——这在历史上（EF Core 7、8、9）也是常态。

如果你不想等待 Pomelo 的更新，希望尽快用上 .NET 10，**Microting.EntityFrameworkCore.MySql** 是一个可行的选择。

---

## 二、Microting 是什么？

Microting.EntityFrameworkCore.MySql 是 Pomelo 的**官方分支（fork）**，由丹麦公司 Microting A/S 维护。它在 NuGet 上明确说明了自己的定位：

> *"This is a fast moving version of Pomelo.EntityFrameworkCore.MySql intended to follow .net release cycle closely! There are no intentions for this package to implement new features."*
>
> （这是 Pomelo 的快速迭代版本，旨在紧密跟随 .NET 发布周期！本包无意实现新功能。）

简单来说，Microting 的核心特点是：

- **紧跟 .NET 节奏**：.NET 10 发布后不久就推出了稳定版，目前最新版本为 10.0.9
- **API 完全兼容**：作为 Pomelo 的直接分支，除了命名空间不同，核心 API 完全一致
- **不做新功能**：功能与 Pomelo 对齐，新功能需求仍提交给上游 Pomelo 项目
- **商业公司维护**：Microting 自身产品深度依赖 EF Core+MySQL，有持续维护的动力

已有不少知名开源项目采用了 Microting，包括 Squidex（Headless CMS）、Smartstore（开源电商）、IoTSharp（IoT 平台）等，从侧面验证了其可用性。

---

## 三、两者对比：差异比你想象的小

| 对比项 | Pomelo 9.0.0 | Microting 10.0.9 |
|---|---|---|
| 目标框架 | .NET 8.0 | .NET 10.0 |
| EF Core 版本 | 9.0.x | 10.0.x |
| 根命名空间 | `Pomelo.EntityFrameworkCore.MySql` | `Microting.EntityFrameworkCore.MySql` |
| 核心 API（`UseMySql` 等） | ✅ | ✅ 完全相同 |
| JSON/空间数据扩展包 | ✅ | ✅ 对应提供 |
| 底层驱动 | MySqlConnector >= 2.4.0 | MySqlConnector >= 2.6.0 |
| 维护模式 | 社区驱动 | 商业公司驱动 |
| NuGet 下载量 | ~1.26 亿 | ~28.6 万 |

**一句话总结：改个命名空间，其他基本不用动。**

---

## 四、迁移步骤（5步搞定）

由于 API 高度兼容，迁移过程非常简单。

### 步骤1：替换 NuGet 包

卸载 Pomelo 包，安装对应 Microting 包：

```bash
# 卸载 Pomelo
dotnet remove package Pomelo.EntityFrameworkCore.MySql
dotnet remove package Pomelo.EntityFrameworkCore.MySql.Json.Microsoft
dotnet remove package Pomelo.EntityFrameworkCore.MySql.Json.Newtonsoft
dotnet remove package Pomelo.EntityFrameworkCore.MySql.NetTopologySuite

# 安装 Microting（版本号保持一致）
dotnet add package Microting.EntityFrameworkCore.MySql --version 10.0.9
dotnet add package Microting.EntityFrameworkCore.MySql.Json.Microsoft --version 10.0.9
dotnet add package Microting.EntityFrameworkCore.MySql.Json.Newtonsoft --version 10.0.9
dotnet add package Microting.EntityFrameworkCore.MySql.NetTopologySuite --version 10.0.9
```

### 步骤2：全局替换命名空间

在 IDE 中使用全局替换，将所有 `using Pomelo.` 替换为 `using Microting.`：

```csharp
// 修改前
using Pomelo.EntityFrameworkCore.MySql;
using Pomelo.EntityFrameworkCore.MySql.Infrastructure;

// 修改后
using Microting.EntityFrameworkCore.MySql;
using Microting.EntityFrameworkCore.MySql.Infrastructure;
```

### 步骤3：DbContext 配置无需改动

`UseMySql()` 方法签名和用法完全一致：

```csharp
services.AddDbContext<AppDbContext>(options =>
    options.UseMySql(connectionString,
        serverVersion => serverVersion.ServerVersion(new MySqlServerVersion(new Version(8, 0, 30))))
);
```

### 步骤4：处理迁移文件

检查 `Migrations` 目录下的文件，将其中硬编码的 `Pomelo` 命名空间替换为 `Microting`。然后生成一个新迁移来更新快照：

```bash
dotnet ef migrations add SwitchToMicroting
dotnet ef database update
```

这个迁移通常是空操作（数据库结构不会变化），只是更新模型快照中的提供程序信息。

### 步骤5：全面测试

运行单元测试和集成测试，重点验证：
- 基础 CRUD 操作是否正常
- LINQ 查询翻译是否正确
- 迁移能否正常应用/回滚
- JSON 列、空间数据等高级功能（如有使用）

---

## 五、注意事项

1. **第三方库兼容性**：这是最可能遇到的问题。如果项目中依赖了硬编码引用 Pomelo 的第三方库（如某些批量操作扩展），需要确认是否有兼容 Microting 的版本。

2. **回滚很容易**：迁移操作主要是包替换和命名空间替换，反向操作即可回滚到 Pomelo。建议在独立 Git 分支上操作，迁移前做好数据库备份。

3. **连接字符串兼容**：两者都基于 MySqlConnector，连接字符串格式完全一致，无需修改。

4. **长期选择**：Microting 明确不添加新功能，如果未来 Pomelo 恢复快速更新，你可以随时迁回——API 兼容性让切换成本很低。也可以将 Microting 视为一个过渡方案。

---

## 六、如何选择？

**适合选择 Microting 的情况：**
- 希望尽快升级到 .NET 10 LTS，不想等待 Pomelo
- 项目升级计划不希望因提供程序版本而推迟
- 没有大量依赖 Pomelo 特有功能的第三方库

**可以继续使用 Pomelo 的情况：**
- 项目暂无升级 .NET 10 的计划
- 对稳定性和生态成熟度要求极高
- 深度依赖基于 Pomelo 的第三方库
- 时间充裕，可以等待 Pomelo 官方更新

---

## 写在最后

Pomelo 为 .NET 社区做出了巨大贡献，Microting 的出现不是为了取代它，而是为那些希望紧跟 .NET 版本节奏的开发者提供了另一种选择。

由于两者 API 高度兼容，切换成本很低——改几个命名空间，换个 NuGet 包，就能用上 .NET 10。如果未来 Pomelo 推出了 EF Core 10 支持版本，你也可以随时切回去。

技术选型从来不是非此即彼，根据自己的项目节奏和需求做出选择就好。

---

**参考链接：**
- [NuGet - Pomelo.EntityFrameworkCore.MySql](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql)
- [NuGet - Microting.EntityFrameworkCore.MySql](https://www.nuget.org/packages/Microting.EntityFrameworkCore.MySql)
- [Microsoft - EF Core 10 新增功能](https://learn.microsoft.com/zh-cn/ef/core/what-is-new/ef-core-10.0/whatsnew)

想尽快升级到 .NET 10，但 Pomelo 还没支持 EF Core 10？本文介绍一个兼容方案——Microting.EntityFrameworkCore.MySql，以及如何平滑切换。

升级 .NET 10 不等 Pomelo？试试 Microting.MySql

本文将带你了解：想尽快升级 .NET 10 但 Pomelo 还没支持 EF Core 10 怎么办？Microting 是什么？如何平滑完成迁移？

编程语言

数据库

开发工具

本文介绍.NET10升级方案：当Pomelo未支持EFCore10时，可改用Microting.EntityFrameworkCore.MySql。Microting是Pomelo官方分支，API完全兼容，只需替换命名空间和NuGet包即可平滑迁移。文章详细对比两者差异，提供5步迁移指南，帮助开发者快速升级到.NET10，同时保持MySQL数据库功能完整。

单元测试

集成测试

MariaDB

MySQL

JSON

腾讯云数据库特惠，新用户首单0.5折起


2026年中大促 | AI 领航 智绘未来

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

本文介绍.NET10升级方案：当Pomelo未支持EFCore10时，可改用Microting.EntityFrameworkCore.MySql。Microting是Pomelo官方分支，API完全兼容，只需替换命名空间和NuGet包即可平滑迁移。文章详细对比两者差异，提供5步迁移指南，帮助开发者快速升级到.NET1...

升级 .NET 10 不等 Pomelo？试试 Microting.MySql-腾讯云开发者社区-腾讯云

升级 .NET 10 不等 Pomelo？试试 Microting.MySql

升级 .NET 10 不等 Pomelo？试试 Microting.MySql

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐