在前后端开发场景中，UUID v4是生成唯一标识的常用方案，它由32个十六进制字符组成，通过随机数生成，碰撞概率极低。部分业务场景下我们需要给UUID添加固定前缀，用来区分不同业务模块、数据类型或者环境标识，比如用户ID前缀为user_，订单ID前缀为order_，这样能提升标识的可读性和管理效率。
UUID v4的结构说明
标准的UUID v4格式为8-4-4-4-12的字符分段，总共36个字符（包含4个连字符），其中版本位固定为4，变体位固定为8、9、a、b中的一个。其核心生成逻辑是获取足够长度的随机字节，再按照规则替换对应位置的字符，最终拼接成标准格式。
带指定前缀的生成实现
生成带前缀的UUID v4不需要修改UUID本身的生成规则，只需要在生成标准UUID v4之后拼接上指定前缀即可，这样既保证了UUID的唯一性，又满足了前缀需求。下面是完整的实现代码：
/**
* 生成带指定前缀的UUID v4
* @param {string} prefix 指定的前缀，默认为空字符串
* @returns {string} 带前缀的UUID v4字符串
*/
function generatePrefixedUUIDv4(prefix = '') {
// 生成随机字节数组，UUID v4需要16字节的随机数据
const randomBytes = new Uint8Array(16);
// 使用crypto.getRandomValues获取密码学安全的随机数，比Math.random更可靠
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;
}
// 使用示例
console.log(generatePrefixedUUIDv4('user')); // 输出类似 user_f47ac10b-58cc-4372-a567-0e02b2c3d479
console.log(generatePrefixedUUIDv4('order')); // 输出类似 order_a1b2c3d4-5678-90ef-1234-567890abcdef
console.log(generatePrefixedUUIDv4()); // 输出标准UUID v4，无前缀
实现要点说明
- 使用
crypto.getRandomValues生成随机数，比Math.random生成的随机数更安全，适合生成唯一标识场景，避免随机数可预测导致的标识碰撞问题。 - 严格按照UUID v4的规范设置版本位和变体位，保证生成的UUID符合标准，可被其他支持UUID的系统正常识别。
- 前缀和UUID之间添加下划线分隔，避免前缀的最后一个字符和UUID的第一个字符粘连，提升可读性，如果不需要分隔符可以调整拼接逻辑去掉下划线。
适用场景
这种生成方式适用于所有需要唯一标识且需要区分类型的场景，比如数据库主键生成、前端临时数据标记、接口请求唯一ID、分布式系统内的数据追踪标识等。如果前缀需要动态变化，只需要调用函数时传入不同的前缀参数即可，复用性很强。
注意事项
如果运行环境不支持crypto.getRandomValues（比如部分旧版浏览器），可以替换为Math.random生成随机数，但需要注意Math.random不是密码学安全的，高并发场景下碰撞概率会略有提升，非敏感场景可以使用。
另外生成的UUID是字符串类型，如果需要存储到数据库，建议设置对应的字段长度为前缀长度加37（标准UUID v4长度为36，加1个下划线），避免长度不足导致截断。
JavaScriptUUID_v4指定前缀唯一标识修改时间：2026-07-14 04:27:22