Python 生成 UUID:uuid 模块用法与版本区别

Released: 2026年11月16日
📅 最后更新:2026年11月16日

在 Python 中生成 UUID,最简单的做法是导入标准库 uuid,再调用 uuid.uuid4()。返回值是 UUID 对象;用 str() 可得到带连字符的文本,用 .hex 可得到不带连字符的十六进制文本。UUID 适合标记记录、文件等对象,不应当作密码或访问凭据。

import uuid

value = uuid.uuid4()
print(value)
print(str(value))
print(value.hex)

UUID 是“通用唯一标识符”的缩写,用来为对象分配标识。它的设计目标是降低不同对象获得相同标识的可能性,并不保证数学意义上的绝对不重复。以下分步说明如何生成、转换和检查 UUID。如果你正在学习 Python 语言,这也是练习标准库的一个简单例子。

第一步:导入标准库模块

uuid 属于 Python 标准库,不需要另外安装软件包。先写 import uuid,之后通过模块名调用函数。还可以阅读 Python 标准库与进阶语法介绍了解更多标准库内容。

UUID 常见的文本形式由十六进制字符组成,并用连字符分组:

123e4567-e89b-42d3-a456-426614174000

这是格式示例,不是每次运行都会得到的固定值。

第二步:按用途选择 UUID 版本

新建标识时,我通常建议先考虑 uuid4()。如果相同的输入必须稳定地映射到相同标识,可以选择 uuid3() 或 uuid5()。

方法 生成方式 常见用途
uuid1() 使用与时间相关的信息生成 确认生成方式符合项目的隐私和使用要求时
uuid3() 根据命名空间和名称生成可重复结果 相同命名空间与名称需要得到相同标识时
uuid4() 随机生成 创建通用的新标识
uuid5() 根据命名空间和名称生成可重复结果 需要可重复结果,并选择此版本的哈希方式时

uuid3() 使用 MD5,uuid5() 使用 SHA-1;两者都以命名空间和名称为输入。UUID 对象的 version 属性会显示版本号。函数用途、命名空间常量和对象属性可查阅 Python 官方 uuid 模块文档。

第三步:调用 uuid4 生成新标识

import uuid

value = uuid.uuid4()
print(value)
print(value.version)

输出示例:

f47ac10b-58cc-4372-a567-0e02b2c3d479
4

每次调用 uuid4() 都可能得到不同结果。上面的标识只用于展示格式;value.version 显示版本号 4。

第四步:将 UUID 转为字符串或去掉连字符

uuid.uuid4() 返回 UUID 对象,而不是字符串。如果要存入文本字段或拼入文件名,可以显式转换:

text = str(value)
plain = value.hex
without_hyphens = str(value).replace("-", "")

print(text)
print(plain)
print(without_hyphens)
写法 结果形式
str(value) 带连字符的 UUID 文本
value.hex 不带连字符的十六进制文本
str(value).replace("-", "") 删除连字符后的文本

.hex 和 replace() 只改变同一个 UUID 的文本表示,不会创建新标识。比如,可以在文件名中加入 UUID 的十六进制形式:

filename = f"report_{value.hex}.csv"

订单系统也可以把 UUID 用作内部订单标识。不过,UUID 不便于口头沟通,也不能自动变成易读的客户订单号。

第五步:检查生成结果,并区分标识与凭据

运行前后可以核对以下几点:

  1. 已写入 import uuid。
  2. 调用的是 uuid.uuid4(),而不是把模块名当成函数。
  3. 需要文本时,使用 str(value) 或 .hex。
  4. UUID 版本符合实际用途。
  5. 不把 UUID 当作密码、验证码或访问授权凭据。

UUID 用于识别对象,不会自动授予访问权限。系统仍需单独检查用户是否有权查看或修改资源。对于重要数据,应用也应处理标识意外重复的情况。想了解随机数相关主题,可继续阅读 Python 随机数模块教程;这里不展开随机数的实现细节。

常见问题

uuid1 和 uuid4 有什么区别?

uuid1() 使用与时间相关的信息生成;uuid4() 随机生成。一般创建新标识时,可以先选 uuid4()。如果考虑 uuid1(),应先了解它的生成方式及可能涉及的隐私影响。

uuid3 和 uuid5 的结果可以重复吗?

可以。相同的命名空间和名称会得到可重复的结果。两种方法采用不同的哈希方式,适合需要把名称稳定映射为标识的场景。

UUID 可以当密码吗?

不可以。标识符不是密码管理方案,也不能替代身份验证、权限检查或专门的秘密凭据。

UUID 和 UID 是同一个概念吗?

不完全相同。UID 泛指用户或对象标识;UUID 则是一种具有特定格式和生成版本的标识符。

如果接下来要学习另一种文本编码主题,可以阅读 Python Base64 编码教程。Base64 编码与 UUID 的字符串表示是不同内容。更多 Python 学习资料可从 Python 下载首页进入。

参考资料

Related Resources