LS
Section: 用户命令 (1)Updated: 2022年9月
查看本页索引 返回目录
名称
ls - 列出目录内容概述
ls [,选项/]... [,文件列表/]...描述
列出指定“文件”（默认为当前目录）的信息。如果既没有指定 -cftuvSUX 中任何一个，也没有指定 --sort，则按字母排序项目。
必选参数对长短选项同时适用。
- -a, --all
- 不要忽略以点号（“.”）起始的条目
- -A, --almost-all
- 不要列出隐含的 . 和 ..
- --author
- 与 -l 同时使用时，列出每个文件的作者
- -b, --escape
- 将无法显示的字符显示为C风格的转义形式
- --block-size=,大小/
- 与 -l 同时使用时，打印文件大小前将其除以指定的块大小；例如："--block-size=M"；参见下方的“大小”格式
- -B, --ignore-backups
- 不要列出以 ~ 结尾的项目
- -c
- 与 -lt 一起使用时：按照 ctime 排序，并显示 ctime（文件状态信息最后变更的时间）；与 -l 一起使用时：显示 ctime 并按照名称排序；其它情况：按照 ctime 排序，最新的最前
- -C
- 逐列列出项目
- --color[=,何时/]
- 指定何时使用彩色输出；更多信息请见下文
- -d, --directory
- 列出目录本身，而不是目录的内容
- -D, --dired
- 产生适合 Emacs 的 dired 模式使用的输出
- -f
- 按照目录顺序列出各项目
- -F, --classify[=,何时/]
- 指定何时在项目后追加指示符号（*/=@| 中的一个）
- --file-type
- 类似，但不追加 "*" 字符
- --format=,关键字/
- across 同 -x、commas 同 -m、horizontal 同 -x、long 同 -l、single-column 同 -1、verbose 同 -l、vertical 同 -C
- --full-time
- 等于 -l --time-style=,full-iso/
- -g
- 类似 -l，但不列出所有者
- --group-directories-first
- 将目录排在文件前面；此选项可与 --sort 一起使用，但是一旦使用 --sort=,none/ (-U) 则禁用此选项
- -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=,模式/
- 隐藏符合指定 shell 模式的项目（-a 或 -A 使此选项失效）
- --hyperlink[=,何时/]
- 指定何时使用超链接显示文件名
- --indicator-style=,关键字/
- 指定在项目名称后追加的指示符号的风格：none（默认）、slash（同 -p）、file-type（同 --file-type）、classify（同 -F）
- -i, --inode
- 显示每个文件的索引编号（inode 号）
- -I, --ignore=,模式字符串/
- 隐藏符合给定 shell 模式字符串的项目
- -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=,关键字/
- 使用指定的加引号方式显示项目名称：literal、locale、shell、shell-always、shell-escape、shell-escape-always、c、escape（该选项优先于 QUOTING_STYLE 环境变量）
- -r, --reverse
- 排序时逆序排列
- -R, --recursive
- 递归列出子目录内容
- -s, --size
- 显示给每个文件分配的大小，单位为块
- -S
- 根据文件大小排序，最大的最前
- --sort=,关键字/
- 按照关键字而非名称进行排序：none（同 -U）、size（同 -S）、time（同 -t）、version（同 -v）、extension（同 -X）、width
- --time=,关键字/
- 改变使用的时间类型，默认为修改时间；访问时间（同 -u）：atime、access、use；变更时间（同 -c）：ctime、status；创建时间：birth、creation；
- 和 -l 同时使用时，关键字 指定要显示的时间类型；和 --sort=time 同时使用时，按照关键字进行排序（最新的最前）
- --time-style=,时间风格/
- 使用 -l 时显示的时间/日期格式；参见下面“时间风格”的相关内容
- -t
- 按时间排序，最新的最前；参见 --time
- -T, --tabsize=,列数/
- 指定制表符宽度为给定列数，而非默认的 8
- -u
- 与 -lt 同时使用时：显示访问时间且按访问时间排序；与 -l 同时使用时：显示访问时间但按名称排序；其他情况：按访问时间排序，最新的最前
- -U
- 不进行排序；按照目录顺序列出项目
- -v
- 对文本中的数字（或版本号）进行自然排序
- -w, --width=,列数/
- 设置输出宽度为指定列数。0 表示无限制
- -x
- 逐行列出项目而不是逐列列出
- -X
- 按照扩展名的字母顺序排序
- -Z, --context
- 输出每个文件的所有安全上下文信息
- --zero
- 以 NUL 字符而非换行结束每个输出行
- -1
- 每行只列出一个文件
- --help
- 显示此帮助信息并退出
- --version
- 显示版本信息并退出
大小的参数是一个整数，后面可以跟一个单位（例如：10K 指 10*1024）。可用的单位有 K、M、G、T、P、E、Z、Y（1024 的幂）以及 KB、MB、...（1000 的幂）。也可以使用二进制前缀：KiB=K、MiB=M，以此类推。
时间风格参数可以是 full-iso、long-iso、iso、locale，或者“+格式”。“格式”的解析方式同 date(1)。如果“格式”是 格式1<换行符>格式2 的话，则 格式1 将应用于时间较久远的文件，格式2 将应用于时间较近的文件。“时间风格”如果带有 "posix-" 前缀，则它只会在区域设置非 POSIX 时生效。另外，可以使用 TIME_STYLE 环境变量设置默认使用的风格。
“何时”参数的默认值是 "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/zh_CN.html> 报告翻译错误。
版权
Copyright © 2022 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.本软件是自由软件：您可以自由修改和重新发布它。在法律允许的范围内，不提供任何保证。
参见
dircolors(1)
完整文档请见： <https://www.gnu.org/software/coreutils/ls>
或者在本地使用： info '(coreutils) ls invocation'
本页面中文版由中文 man 手册页计划提供。
中文 man 手册页计划：https://github.com/man-pages-zh/manpages-zh
Index
This document was created by man2html, using the manual pages.
Time: 03:15:41 GMT, July 01, 2024
