在 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 不便于口头沟通,也不能自动变成易读的客户订单号。
第五步:检查生成结果,并区分标识与凭据
运行前后可以核对以下几点:
- 已写入
import uuid。 - 调用的是
uuid.uuid4(),而不是把模块名当成函数。 - 需要文本时,使用
str(value)或.hex。 - UUID 版本符合实际用途。
- 不把 UUID 当作密码、验证码或访问授权凭据。
UUID 用于识别对象,不会自动授予访问权限。系统仍需单独检查用户是否有权查看或修改资源。对于重要数据,应用也应处理标识意外重复的情况。想了解随机数相关主题,可继续阅读 Python 随机数模块教程;这里不展开随机数的实现细节。
常见问题
uuid1 和 uuid4 有什么区别?
uuid1() 使用与时间相关的信息生成;uuid4() 随机生成。一般创建新标识时,可以先选 uuid4()。如果考虑 uuid1(),应先了解它的生成方式及可能涉及的隐私影响。
uuid3 和 uuid5 的结果可以重复吗?
可以。相同的命名空间和名称会得到可重复的结果。两种方法采用不同的哈希方式,适合需要把名称稳定映射为标识的场景。
UUID 可以当密码吗?
不可以。标识符不是密码管理方案,也不能替代身份验证、权限检查或专门的秘密凭据。
UUID 和 UID 是同一个概念吗?
不完全相同。UID 泛指用户或对象标识;UUID 则是一种具有特定格式和生成版本的标识符。
如果接下来要学习另一种文本编码主题,可以阅读 Python Base64 编码教程。Base64 编码与 UUID 的字符串表示是不同内容。更多 Python 学习资料可从 Python 下载首页进入。