> For the complete documentation index, see [llms.txt](https://man.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://man.bsdcn.org/man1/uuidgen.1.md).

# uuidgen(1)

`uuidgen` — 生成通用唯一标识符

## 名称

`uuidgen`

## 概要

`uuidgen [-1cr] [-n count] [-o filename]`

## 描述

`uuidgen` 实用程序默认生成一个 DCE 版本 1 通用唯一标识符（UUID），也称为全局唯一标识符（GUID）。UUID 默认写入标准输出。以下选项可用于更改 `uuidgen` 的行为：

**`-1`** 此选项仅在需要生成多个标识符时生效，指示 `uuidgen` 不要批量生成，而是逐个生成。

**`-c`** 此选项控制创建紧凑格式的 UUID（不含连字符）。

**`-n`** 此选项控制生成的标识符数量。默认情况下，多个标识符以批量方式生成。

**`-o`** 将输出重定向到 `filename` 而非标准输出。

**`-r`** 此选项控制创建随机 UUID（版本 4）。

批量生成会产生一组密集的标识符，使得在该集合中不存在比集合中最小标识符大且比最大标识符小、但又不属于该集合的标识符。

逐个生成标识符时，各个标识符之间会彼此接近，但操作系统的延迟和处理时间会反映在两个连续标识符之间的差距上。

## 退出状态

`uuidgen` 实用程序成功时退出值为 0，发生错误时大于 0。

## 实例

生成一批三个 UUID。注意 UUID 第一个连字符之前的字符串（在 *rfc4122* 中称为 *time\_low*）的相似性：

```sh
$ uuidgen -n3
8bc44345-4d90-11ee-88c7-b42e991fc52e
8bc44346-4d90-11ee-88c7-b42e991fc52e
8bc44347-4d90-11ee-88c7-b42e991fc52e
```

生成一批不含连字符的随机 UUID：

```sh
$ uuidgen -r -c -n3
5ad8b60a0f4e41f59c82d273202275f9
6c41925486cd4bf59720a5bad85de2e4
8144fdab63f648a1812d12453f975313
```

注意这些 UUID 彼此之间并不相似。

## 参见

uuidgen(2), uuid(3)

## 历史

`uuidgen` 命令首次出现于 FreeBSD 5.0。