ls - 列出目录内容
概要
ls [选项]... [文件]...
描述
列出关于文件的信息（默认情况下为当前目录）。如果没有指定 -cftuvSUX 或 --sort，则按字母顺序对条目进行排序。
长选项的必需参数对于短选项也是必需的。
选项
-a, --all
不要忽略以 . 开头的条目。
-A, --almost-all
不要列出隐含的 . 和 ..。
--author
与 -l 配合使用时，打印每个文件的作者。
-b, --escape
以 C 风格转义非图形字符。
--block-size=SIZE
与 -l 配合使用时，打印大小信息时按 SIZE 缩放；例如，'--block-size=M'；有关 SIZE 格式的更多信息，请参见下文。
-B, --ignore-backups
不要列出以 ~ 结尾的隐含条目。
-c 与 -lt 配合使用时：按 ctime（上次更改文件状态信息的时间）排序并显示；与 -l 配合使用时：显示 ctime 并按名称排序；否则：按 ctime 排序，最新的排在第一位。
-C 按列显示条目。
--color[=WHEN]
WHEN 时为输出着色；有关更多信息，请参见下文。
-d, --directory
列出目录本身，而不是其内容。
-D, --dired
生成专为 Emacs 的 dired 模式设计的输出。
-f 与 -a -U 相同。
-F, --classify[=WHEN]
WHEN 时，将指示符（*/=>@| 中的一个）附加到条目。
--file-type
与上相同，但不要附加 *。
--format=WORD
across、horizontal (-x)、commas (-m)、long (-l)、single-column (-1)、verbose (-l)、vertical (-C)。
--full-time
类似于 -l --time-style=full-iso。
-g 类似于 -l，但不要列出所有者。
--group-directories-first
在文件之前对目录进行分组。
-G, --no-group
在长列表中，不要打印组名。
-h, --human-readable
与 -l 和 -s 配合使用时，以 1K 234M 2G 等形式打印大小。
--si 同样，但使用 1000 的幂而不是 1024。
-H, --dereference-command-line
跟踪命令行中列出的符号链接。
--dereference-command-line-symlink-to-dir
跟踪每个指向目录的命令行符号链接。
--hide=PATTERN
不要列出与 shell PATTERN 匹配的隐含条目（由 -a 或 -A 覆盖）。
--hyperlink[=WHEN]
WHEN 时，将文件名超链接。
--indicator-style=WORD
将具有 WORD 样式的指示符附加到条目名称：无（默认）、斜杠 (-p)、文件类型 (--file-type)、分类 (-F)。
-i, --inode
打印每个文件的索引号。
-I, --ignore=PATTERN
不要列出与 shell PATTERN 匹配的隐含条目。
-k, --kibibytes
默认使用 1024 字节的块进行文件系统使用；仅与 -s 和每个目录的总计一起使用。
-l 使用长列表格式。
-L, --dereference
在显示符号链接的文件信息时，显示链接指向的文件的信息，而不是链接本身的信息。
-m 用逗号分隔的条目填充宽度。
-n, --numeric-uid-gid
类似于 -l，但列出数值用户和组 ID。
-N, --literal
打印条目名称时不使用引号
-o 类似于 -l，但不列出组信息
-p, --indicator-style=slash
在目录后附加 / 指示符
-q, --hide-control-chars
打印 ? 代替非图形字符
--show-control-chars
按原样显示非图形字符（默认，除非程序为 'ls' 且输出到终端）
-Q, --quote-name
将条目名称括在双引号中
--quoting-style=WORD
为条目名称使用引号样式 WORD：literal、locale、shell、shell-always、shell-escape、shell-escape-always、c、escape（覆盖 QUOTING_STYLE 环境变量）
-r, --reverse
反向排序
-R, --recursive
递归地列出子目录
-s, --size
打印每个文件的已分配大小，以块为单位
-S 按文件大小排序，从大到小
--sort=WORD
将默认的 'name' 排序更改为 WORD：none (-U)、size (-S)、time (-t)、version (-v)、extension (-X)、name、width
--time=WORD
选择用于显示或排序的时间戳；访问时间 (-u)：atime、access、use；
元数据更改时间 (-c)：ctime、status；修改时间（默认）：mtime、modification；
创建时间：birth、creation；
与 -l 结合使用时，WORD 确定要显示的时间；与 --sort=time 结合使用时，按 WORD 排序（最新的优先）
--time-style=TIME_STYLE
与 -l 结合使用时的日期/时间格式；请参见 TIME_STYLE
-t 按时间排序，最新的优先；请参见 --time
-T, --tabsize=COLS
假设制表符停止位置为每个 COLS，而不是 8
-u 与 -lt 结合使用时：按访问时间排序并显示；与 -l 结合使用时：显示访问时间并按名称排序；否则：按访问时间排序，最新的优先
-U 不按目录条目排序
-v 按（版本）数字进行自然排序
-w, --width=COLS
将输出宽度设置为 COLS。0 表示没有限制
-x 按行而不是按列列出条目
-X 按条目扩展名进行字母排序
-Z, --context
打印每个文件的任何安全上下文
--zero
使用 NUL 而不是换行符结束每个输出行
-1 每行列出一个文件
--help
显示此帮助信息并退出
--version
输出版本信息并退出
参数
SIZE 参数是一个整数，并且是可选的单位（例如：10K 是 10*1024）。 单位为 K、M、G、T、P、E、Z、Y、R、Q（1024 的幂），或 KB、MB（1000 的幂）。 也可以使用二进制前缀：KiB=K、MiB=M，依此类推。
TIME_STYLE 参数可以是 full-iso、long-iso、iso、locale 或 +FORMAT。 FORMAT 的解释方式与 [date]({filename}../../date)(1) 中的 FORMAT 相同。 如果 FORMAT 是 FORMAT1<换行符>FORMAT2，则 FORMAT1 适用于非最近的文件，FORMAT2 适用于最近的文件。 以 'posix-' 开头的 TIME_STYLE 仅在 POSIX 区域设置之外生效。 此外，TIME_STYLE 环境变量设置要使用的默认样式。
WHEN 参数默认为 'always'，也可以是 'auto' 或 'never'。
使用颜色区分文件类型，默认情况下禁用，并通过 --color=never 禁用。 使用 --color=auto 时，ls 仅在标准输出连接到终端时才输出颜色代码。 LS_COLORS 环境变量可以更改设置。 使用 dircolors(1) 命令进行设置。
退出状态：
0 如果一切正常，
1 如果存在小问题（例如，无法访问子目录），
2 如果存在严重问题（例如，无法访问命令行参数）。
作者
由 Richard M. Stallman 和 David MacKenzie 编写。
报告错误
GNU coreutils 在线帮助：[https://www.gnu.org/software/coreutils/] 请将任何翻译错误报告到 [https://translationproject.org/team/]
参见
dircolors(1)
完整文档 [https://www.gnu.org/software/coreutils/ls] 或可在本地通过以下方式获取：info '(coreutils) ls invocation'
由 Debian 软件包 (9.7-3) 提供 版权所有 © 2025 自由软件基金会。 许可证 GPLv3+：GNU GPL 第 3 版或更高版本 [https://gnu.org/licenses/gpl.html]。 这是一个自由软件：您可以自由地修改和重新分发它。 在法律允许的范围内，不提供任何保证。