C#中Guid唯一标识_C#全局唯一标识符教程【入门】

风婷姑娘_1262

风婷姑娘_1262

2026-05-14

554人浏览

原创

应使用 guid.newguid() 生成新 guid,new guid() 仅返回全零值;解析用 tryparse,输出按场景选 tostring("n")/("b")/("d") 格式,ef core 中需明确主键策略。

c#中guid唯一标识_c#全局唯一标识符教程【入门】

直接用 Guid.NewGuid() 就行,99% 的场景下这是唯一需要的操作;别用 new Guid(),它永远返回全零值 "00000000-0000-0000-0000-000000000000",不是“新 ID”。

Guid.NewGuid() vs new Guid():一个生成,一个清零

这是最常踩的坑——把构造函数当工厂方法用。new Guid() 是结构体默认构造,语义上就是“初始化为零”,和 new int() 得 0、new bool() 得 false 一样自然,但它在业务中常被误当作“占位新 ID”。一旦用于数据库主键或 API 返回,所有记录都会共享同一个 Guid.Empty,轻则插入失败(SQL Server 报 Cannot insert the value NULL into column 'Id'),重则数据被覆盖。

而 Guid.NewGuid() 调用的是操作系统级密码学随机源(Windows 用 BCryptGenRandom,Linux/macOS 用 /dev/urandom),线程安全、无需配置、跨 .NET 版本行为一致。

  • EF Core 中若实体属性是 public Guid Id { get; set; } 且没显式赋值,插入时传的就是 Guid.Empty
  • 判断是否未设置,写 guid == Guid.Empty,别用 string.IsNullOrEmpty(guid.ToString())(永远 false)或 guid.ToString() == ""(会抛 NullReferenceException)
  • 需要可空语义,直接用 Guid? 类型,比靠 Guid.Empty 约定更清晰

ToString() 格式选错,JSON 和 URL 就解析失败

GUID 默认转字符串是 "D" 格式(带短横线,36 字符),但不同场景对格式敏感:

  • 存数据库字面量(如 SQL Server):用 guid.ToString("B") → "{a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8}",别手动拼 "{" + guid + "}"
  • 传 JSON 或 URL 参数:推荐 guid.ToString("N")(32 字符无横线),避免 Replace("-", "") 多一次字符串分配,也防 null 崩溃
  • 日志或调试输出:用 guid.ToString("D") 或 guid.ToString("D").ToUpperInvariant(),可读性高、易比对
  • 别试 ToString("X") —— GUID 不支持该格式,直接抛 FormatException

从字符串解析 GUID 必须用 TryParse

外部输入(API 请求体、数据库查出的字符串、用户粘贴)不可信。Guid.Parse() 遇到非法格式(比如多空格、中文、下划线、33 位十六进制)立刻炸;Guid.TryParse() 才是生产环境唯一安全选择。

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

它支持带/不带横杠、大小写混用、甚至带花括号,只要字符是合法的 32 或 36 位十六进制 + 分隔符即可:

  • Guid.TryParse("9b1deb4d3b584709850c61e63514d74f", out var g) → 成功
  • Guid.TryParse("9b1deb4d-3b58-4709-850c-61e63514d74f", out var g) → 同样成功
  • 但 Guid.TryParse("9b1deb4d-3b58-4709-850c-61e63514d74f ", out var g)(末尾空格)→ 失败

别用 new Guid(string) 处理不可信输入,没有容错余地。

性能与序列化里容易被忽略的细节

GUID 本身是 16 字节值类型,开销极小;问题出在字符串操作和上下文约定上:

  • 高频生成(如每秒万级日志 ID)时,保留 Guid 类型变量,仅在必要输出时调 ToString("N"),避免反复分配字符串
  • 缓存 Key 或字典查找中,同一 GUID 若有时小写、有时大写(如 guid.ToString() vs guid.ToString().ToUpper()),会被当成两个不同 Key
  • JSON 序列化默认把 Guid.Empty 输出为 "00000000-0000-0000-0000-000000000000",前端可能误判为有效 ID,需配合业务层做空值过滤
  • 数据库主键用 UNIQUEIDENTIFIER(SQL Server)或 UUID(PostgreSQL),别用 varchar(36) —— 索引效率差、空间浪费近一倍

真正难的不是生成,而是统一字符串格式、守住 TryParse 边界、以及在 EF Core 或 Dapper 映射时明确主键生成策略(ValueGenerated.Never 还是交由数据库)。这些地方一松懈,问题就藏在上线后第三个月的数据修复里。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

c#

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
c#是什么意思
c#是什么意思

C#是一种通用的面向对象编程语言,它在.NET框架上运行,可用于开发各种类型的应用程序。本专题为大家提供c#相关的各种文章、以及下载和课程。

2023.08.08

972

5

什么是c#
什么是c#

C#(读作C Sharp)是一种现代的、通用的、面向对象的编程语言。它由微软公司开发,于2000年首次发布,主要用于开发Windows桌面应用程序、Web应用程序、移动应用程序以及游戏开发等领域。C#是一种类型安全和托管的编程语言,它结合了C++的强大性能和C语言的简单易学特点,并引入了许多新的特性和概念,如委托、属性、泛型和异步编程等,以提高开发效率和代码可维护性。

2023.08.31

2731

3

C#中base关键字的用法
C#中base关键字的用法

在C#中,base关键字用于访问当前类的基类成员,这包括基类的字段、属性、方法、构造函数、索引器以及事件。想了解更多C#的相关内容,可以阅读本专题下面的文章。

2024.03.13

865

8

C#Task用法
C#Task用法

Task在C#中是用于表示异步操作的对象,它位于System.Threading.Tasks命名空间中。想了解更多C#中各种用法的相关内容,可以阅读本专题下面的文章。

2024.03.14

2615

11

C# 并发与异步编程
C# 并发与异步编程

本专题系统讲解 C# 异步编程与并发控制,重点介绍 async 和 await 关键字、Task 类、线程池管理、并发数据结构、死锁与线程安全问题。通过多个实战项目,帮助学习者掌握 如何在 C# 中编写高效的异步代码,提升应用的并发性能与响应速度。

2026.02.03

312

18

C# 多线程与异步编程
C# 多线程与异步编程

本专题深入讲解 C# 中多线程与异步编程的核心概念与实战技巧,包括线程池管理、Task 类的使用、async/await 异步编程模式、并发控制与线程同步、死锁与竞态条件的解决方案。通过实际项目,帮助开发者掌握 如何在 C# 中构建高并发、低延迟的异步系统,提升应用性能和响应速度。

2026.02.06

389

20

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

2026.03.11

611

24

C# Unity游戏开发与ECS架构实践
C# Unity游戏开发与ECS架构实践

本专题聚焦 C# 在 Unity 游戏开发中的应用,系统讲解 ECS(Entity-Component-System)架构设计、游戏对象管理、性能优化与内存控制策略。通过实际游戏案例,帮助开发者构建高性能、结构清晰的游戏系统,提高游戏开发效率与运行性能。

2026.04.13

309

20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习