UUID v4是基于随机数生成的通用唯一识别码，格式为8-4-4-4-12的十六进制字符串，在分布式系统、数据库主键、前端临时标识等场景中被广泛使用。当业务需要区分不同来源的UUID时，给UUID v4添加指定前缀是常见需求，比如给用户相关的UUID添加user_前缀，给订单相关的UUID添加order_前缀。
UUID v4的生成规则
UUID v4的核心特征是版本号为4，变体为RFC 4122规定的格式，具体规则如下：
- 第13位字符固定为4，代表版本号是v4
- 第17位字符只能是8、9、a、b中的一个，代表变体类型
- 其余位置的字符都是随机生成的十六进制字符（0-9、a-f）
实现思路
生成带指定前缀的UUID v4可以分为两个步骤：首先按照UUID v4的规则生成标准的UUID字符串，然后将指定的前缀和生成的UUID字符串拼接即可。需要注意前缀拼接后不会影响UUID本身的随机性和唯一性，只是作为标识的补充信息。
原生JavaScript实现方案
利用浏览器的crypto.getRandomValues API生成随机值，再按照UUID v4的格式拼接字符串，最后添加指定前缀。该方案不需要依赖第三方库，兼容性较好。
/**
* 生成带指定前缀的UUID v4
* @param {string} prefix 指定的前缀，默认为空字符串
* @returns {string} 带前缀的UUID v4字符串
*/
function generateUUIDWithPrefix(prefix = '') {
// 生成16个随机字节
const randomBytes = new Uint8Array(16);
crypto.getRandomValues(randomBytes);
// 设置UUID v4的版本位（第6字节的高4位设为0100，对应十六进制4）
randomBytes[6] = (randomBytes[6] & 0x0f) | 0x40;
// 设置UUID v4的变体位（第8字节的高2位设为10，对应十六进制8、9、a、b）
randomBytes[8] = (randomBytes[8] & 0x3f) | 0x80;
// 将字节转换为十六进制字符串，不足两位补0
const hexParts = [];
for (let i = 0; i < 16; i++) {
hexParts.push(randomBytes[i].toString(16).padStart(2, '0'));
}
// 按照UUID v4的格式拼接：8-4-4-4-12
const uuid = [
hexParts.slice(0, 4).join(''),
hexParts.slice(4, 6).join(''),
hexParts.slice(6, 8).join(''),
hexParts.slice(8, 10).join(''),
hexParts.slice(10, 16).join('')
].join('-');
// 拼接前缀和UUID
return prefix ? `${prefix}${uuid}` : uuid;
}
// 使用示例：生成带user_前缀的UUID v4
const userUUID = generateUUIDWithPrefix('user_');
console.log(userUUID); // 输出类似 user_f4a2b3c1-8d9e-4f7a-b6c2-1d3e5f7a9b0c
使用第三方库实现
如果项目中已经引入了uuid库，也可以直接基于库提供的方法实现，代码更简洁。首先需要安装uuid库，然后调用v4方法生成UUID，再拼接前缀。
// 先安装uuid库：npm install uuid
import { v4 as uuidv4 } from 'uuid';
/**
* 基于uuid库生成带指定前缀的UUID v4
* @param {string} prefix 指定的前缀
* @returns {string} 带前缀的UUID v4
*/
function generateUUIDWithPrefixByLib(prefix = '') {
const uuid = uuidv4();
return prefix ? `${prefix}${uuid}` : uuid;
}
// 使用示例
const orderUUID = generateUUIDWithPrefixByLib('order_');
console.log(orderUUID); // 输出类似 order_a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d
注意事项
- 前缀内容建议只包含字母、数字、下划线等常规字符，避免出现特殊字符导致后续存储或传输出现问题
- 如果前缀本身可能包含UUID的分隔符
-，需要注意和业务UUID的-做区分，避免后续解析时混淆 - 原生实现方案依赖
crypto.getRandomValuesAPI，该API在IE10及以下版本不支持，如果需要兼容低版本浏览器，可以替换为Math.random()生成随机值，但随机性会略有下降 - 生成的带前缀的UUID总长度会增加，设计数据库字段长度时需要预留足够的空间
常见问题解答
前缀会影响UUID的唯一性吗
不会，UUID的唯一性由随机生成的16字节内容保证，前缀只是附加的字符串，不会改变UUID本身的随机部分，因此不会影响唯一性。
可以生成带多个前缀的UUID吗
可以，只需要在拼接时按照需求添加多个前缀即可，比如generateUUIDWithPrefix('user_', 'temp_')可以调整为拼接两个前缀，根据实际业务需求修改拼接逻辑即可。
UUID_v4JavaScriptUUID生成指定前缀修改时间：2026-07-03 08:42:23