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>.
本软件是自由软件:您可以自由修改和重新发布它。在法律允许的范围内,不提供任何保证。
完整文档请见: <https://www.gnu.org/software/coreutils/ls>
或者在本地使用: info '(coreutils) ls invocation'
本页面中文版由中文 man 手册页计划提供。
中文 man 手册页计划:https://github.com/man-pages-zh/manpages-zh