以下是ai工具帮助整理的EF Core 实体字段类型与 MySQL 数据库中常见字段类型的映射关系列表。这个映射基于使用的 EF Core MySQL Provider ( Pomelo.EntityFrameworkCore.MySql) 

请注意：

  • M 在 INT(M) 等类型中通常表示显示宽度，不影响存储大小或数值范围（除非配合 ZEROFILL 使用），因此在映射时主要关注基本类型名称和是否有符号。
  • 空安全 (Nullable) C# 类型（例如 int?, DateTime?）会映射到对应的 MySQL 类型，但数据库列会允许 NULL 值。非空 C# 类型（例如 int, DateTime）则映射到不允许 NULL 值的 MySQL 列（除非显式配置为允许）。
  • 以下列表涵盖了大部分常用类型，但可能不是全部。

EF Core (C#) -> MySQL 数据类型映射

EF Core (C#) 类型 常用 MySQL 类型 备注 / 注意事项
bool TINYINT(1) 或 BOOL MySQL 没有独立的布尔类型，通常映射为 TINYINT(1) (0=false, 1=true)。BOOL 是 TINYINT(1) 的别名。
byte TINYINT UNSIGNED 无符号 8 位整数，范围 0-255。
sbyte TINYINT 有符号 8 位整数，范围 -128 到 127。
short SMALLINT 有符号 16 位整数。
ushort SMALLINT UNSIGNED 无符号 16 位整数。
int INT 或 INTEGER 有符号 32 位整数。
uint INT UNSIGNED 或 INTEGER UNSIGNED 无符号 32 位整数。
long BIGINT 有符号 64 位整数。
ulong BIGINT UNSIGNED 无符号 64 位整数。
float FLOAT 单精度浮点数。
double DOUBLE 或 REAL 双精度浮点数。
decimal DECIMAL 精确小数类型。通常需要指定精度和标度，例如 DECIMAL(18, 2)。EF Core 默认可能会使用一个较大的默认值，但最好显式配置。
char CHAR(1) 单个字符。
string VARCHAR(N) 或 LONGTEXT 可变长度字符串。默认映射取决于 EF Core 的配置，通常是 VARCHAR 带一个最大长度。如果未指定最大长度或长度非常大，可能映射到 TEXT, MEDIUMTEXT, LONGTEXT。
DateTime DATETIME 存储日期和时间。默认情况下，EF Core 不会存储时区信息。请注意 MySQL DATETIME 范围。
DateTimeOffset DATETIME 或 TIMESTAMP 注意: MySQL 的 DATETIME 和 TIMESTAMP 不直接支持时区偏移量。Provider 通常会映射到 DATETIME，但这可能导致时区问题。某些 Provider 或配置下可能映射到 TIMESTAMP (存储 UTC 但有范围限制) 或需要额外处理。这是一种复杂的映射。
DateOnly (仅 .NET 6 及以上) DATE 仅存储日期部分。
TimeOnly (仅 .NET 6 及以上) TIME 仅存储时间部分。
TimeSpan TIME 或 BIGINT 映射到 TIME (存储时间间隔) 或 BIGINT (存储Ticks)。取决于 Provider 的默认行为或你的配置。通常映射到 TIME。
byte[] VARBINARY(N) 或 BLOB 可变长度二进制数据。默认映射取决于 EF Core 的配置，通常是 VARBINARY 带最大长度。如果长度很大或未指定，可能映射到 TINYBLOB, BLOB, MEDIUMBLOB, LONGBLOB。
Guid BINARY(16) 或 VARCHAR(36) 存储 GUID。BINARY(16) 更节省空间和索引效率更高，但存储和读取时需要注意字节序转换。VARCHAR(36) 更易读，但效率较低。Pomelo provider 默认通常是 CHAR(36)。可以配置为 BINARY(16)。
enum INT (或其基础类型) EF Core 默认会将 C# 枚举映射到其基础整数类型（如 int 或 byte），然后该整数类型再映射到对应的 MySQL 整数类型。MySQL 的 ENUM 类型需要自定义 Value Converter。
JsonDocument, JsonElement 或自定义对象 (需配置) JSON 需要使用特定的 Value Converter 或配置才能将 C# JSON 类型或对象映射到 MySQL 的 JSON 类型。

重要提示：

  • Nullable Types: 任何 C# 值类型 (int, bool, DateTime 等) 后面的 ? (int?, bool?, DateTime?) 表示它是可空的。在数据库中，这对应于该列允许存储 NULL 值。引用类型 (string, byte[]) 默认就是可空的，unless configured otherwise.
  • Provider: 上述映射基于常见的 EF Core MySQL Provider (如 Pomelo.EntityFrameworkCore.MySql)。不同的 Provider 或 Provider 版本可能会有细微差别。
  • Fluent API / Data Annotations: 你可以使用 EF Core 的 Fluent API 或 Data Annotations 来覆盖默认的映射行为，例如指定字符串的最大长度，DECIMAL 的精度和标度，或者将 Guid 映射到 BINARY(16)。

-------------------------传统分割线--------------------------------------------------------------

# 数据库 # mysql
Logo
DAMO开发者矩阵

DAMO开发者矩阵，由阿里巴巴达摩院和中国互联网协会联合发起，致力于探讨最前沿的技术趋势与应用成果，搭建高质量的交流与分享平台，推动技术创新与产业应用链接，围绕“人工智能与新型计算”构建开放共享的开发者生态。

更多推荐

老板要的不是聊天机器人：一篇讲明白企业级 Agent 怎么搭

这篇文章用大白话讲清楚企业级 Agent 是什么、需要哪些工具、正确的落地路线是什么，并用报销审核案例说明 Agent 为什么不是聊天机器人。

avatar DAMO开发者矩阵

从场景落地到技术迭代：服务机器人迈入规模化商用爆发期

采用8nm工艺，搭载6TOPS NPU算力，支持8K编解码、多传感器融合、高精度力控、复杂环境自主导航、机械臂动态运动规划，算力性能强劲、体积小巧、功耗可控，可支撑人形康养机器人、高端AI理疗机器人、工业级AMR、四足巡检机器人等高负载、高智能需求的高端设备开发。商用服务机器人主要应用于酒店、商场、写字楼、园区等公共场景，可实现迎宾引路、物品配送、清洁消杀、导购讲解、安防巡逻等标准化重复作业，核心

avatar DAMO开发者矩阵
cover

【论文阅读】StereoVLA: Enhancing Vision-Language-Action Models with Stereo Vision

avatar DAMO开发者矩阵