.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5.
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH LS 1 2022年9月 "GNU coreutils 9.1" 用户命令
.SH 名称
ls \- 列出目录内容
.SH 概述
\fBls\fP [\fI\,选项\/\fP]... [\fI\,文件列表\/\fP]...
.SH 描述
.\" Add any additional description here
.PP
列出指定“文件”(默认为当前目录)的信息。如果既没有指定 \fB\-cftuvSUX\fP 中任何一个,也没有指定 \fB\-\-sort\fP,则按字母排序项目。
.PP
必选参数对长短选项同时适用。
.TP
\fB\-a\fP, \fB\-\-all\fP
不要忽略以点号(“.”)起始的条目
.TP
\fB\-A\fP, \fB\-\-almost\-all\fP
不要列出隐含的 . 和 ..
.TP
\fB\-\-author\fP
与 \fB\-l\fP 同时使用时,列出每个文件的作者
.TP
\fB\-b\fP, \fB\-\-escape\fP
将无法显示的字符显示为C风格的转义形式
.TP
\fB\-\-block\-size\fP=\fI\,大小\/\fP
与 \fB\-l\fP 同时使用时,打印文件大小前将其除以指定的块大小;例如:"\-\-block\-size=M";参见下方的“大小”格式
.TP
\fB\-B\fP, \fB\-\-ignore\-backups\fP
不要列出以 ~ 结尾的项目
.TP
\fB\-c\fP
与 \fB\-lt\fP 一起使用时:按照 ctime 排序,并显示 ctime(文件状态信息最后变更的时间);与 \fB\-l\fP 一起使用时:显示 ctime
并按照名称排序;其它情况:按照 ctime 排序,最新的最前
.TP
\fB\-C\fP
逐列列出项目
.TP
\fB\-\-color\fP[=\fI\,何时\/\fP]
指定何时使用彩色输出;更多信息请见下文
.TP
\fB\-d\fP, \fB\-\-directory\fP
列出目录本身,而不是目录的内容
.TP
\fB\-D\fP, \fB\-\-dired\fP
产生适合 Emacs 的 dired 模式使用的输出
.TP
\fB\-f\fP
按照目录顺序列出各项目
.TP
\fB\-F\fP, \fB\-\-classify\fP[=\fI\,何时\/\fP]
指定何时在项目后追加指示符号(*/=@| 中的一个)
.TP
\fB\-\-file\-type\fP
类似,但不追加 "*" 字符
.TP
\fB\-\-format\fP=\fI\,关键字\/\fP
across 同 \fB\-x\fP、commas 同 \fB\-m\fP、horizontal 同 \fB\-x\fP、long 同 \fB\-l\fP、single\-column
同 \fB\-1\fP、verbose 同 \fB\-l\fP、vertical 同 \fB\-C\fP
.TP
\fB\-\-full\-time\fP
等于 \fB\-l\fP \fB\-\-time\-style\fP=\fI\,full\-iso\/\fP
.TP
\fB\-g\fP
类似 \fB\-l\fP,但不列出所有者
.TP
\fB\-\-group\-directories\-first\fP
将目录排在文件前面;此选项可与 \fB\-\-sort\fP 一起使用,但是一旦使用 \fB\-\-sort\fP=\fI\,none\/\fP (\fB\-U\fP) 则禁用此选项
.TP
\fB\-G\fP, \fB\-\-no\-group\fP
使用长列表格式时,不输出组名
.TP
\fB\-h\fP, \fB\-\-human\-readable\fP
同时使用 \fB\-l\fP 或 \fB\-s\fP 时,将大小表示为 1K 234M 2G 等
.TP
\fB\-\-si\fP
类似,但是使用1000的乘方,不使用1024
.TP
\fB\-H\fP, \fB\-\-dereference\-command\-line\fP
跟随命令行中列出的符号链接
.TP
\fB\-\-dereference\-command\-line\-symlink\-to\-dir\fP
跟随命令行中列出的、指向目录的符号链接
.TP
\fB\-\-hide\fP=\fI\,模式\/\fP
隐藏符合指定 shell 模式的项目(\fB\-a\fP 或 \fB\-A\fP 使此选项失效)
.TP
\fB\-\-hyperlink\fP[=\fI\,何时\/\fP]
指定何时使用超链接显示文件名
.TP
\fB\-\-indicator\-style\fP=\fI\,关键字\/\fP
指定在项目名称后追加的指示符号的风格:none(默认)、slash(同 \fB\-p\fP)、file\-type(同
\fB\-\-file\-type\fP)、classify(同 \fB\-F\fP)
.TP
\fB\-i\fP, \fB\-\-inode\fP
显示每个文件的索引编号(inode 号)
.TP
\fB\-I\fP, \fB\-\-ignore\fP=\fI\,模式字符串\/\fP
隐藏符合给定 shell 模式字符串的项目
.TP
\fB\-k\fP, \fB\-\-kibibytes\fP
显示文件系统使用量时,默认使用 1024 字节的块大小;只用于 \fB\-s\fP 和每个目录的总计
.TP
\fB\-l\fP
使用长列表格式
.TP
\fB\-L\fP, \fB\-\-dereference\fP
显示符号链接的文件信息时,显示符号链接指向的文件的信息,而非符号链接本身的信息
.TP
\fB\-m\fP
所有项目以逗号分隔,并填满整行行宽
.TP
\fB\-n\fP, \fB\-\-numeric\-uid\-gid\fP
类似 \fB\-l\fP,但列出用户和组的 ID 号
.TP
\fB\-N\fP, \fB\-\-literal\fP
输出不加引号的项目名称
.TP
\fB\-o\fP
类似 \fB\-l\fP,但不列出有关组的信息
.TP
\fB\-p\fP, \fB\-\-indicator\-style\fP=\fI\,slash\/\fP
对目录追加 "/" 作为指示符号
.TP
\fB\-q\fP, \fB\-\-hide\-control\-chars\fP
以 "?" 字符代替不可打印的字符
.TP
\fB\-\-show\-control\-chars\fP
原样显示无法打印的字符(这是默认行为,除非被调用时的程序名是 "ls" 且在终端中进行输出)
.TP
\fB\-Q\fP, \fB\-\-quote\-name\fP
在项目名称两侧加上双引号
.TP
\fB\-\-quoting\-style\fP=\fI\,关键字\/\fP
使用指定的加引号方式显示项目名称:literal、locale、shell、shell\-always、shell\-escape、shell\-escape\-always、c、escape(该选项优先于
QUOTING_STYLE 环境变量)
.TP
\fB\-r\fP, \fB\-\-reverse\fP
排序时逆序排列
.TP
\fB\-R\fP, \fB\-\-recursive\fP
递归列出子目录内容
.TP
\fB\-s\fP, \fB\-\-size\fP
显示给每个文件分配的大小,单位为块
.TP
\fB\-S\fP
根据文件大小排序,最大的最前
.TP
\fB\-\-sort\fP=\fI\,关键字\/\fP
按照关键字而非名称进行排序:none(同 \-U)、size(同 \-S)、time(同 \-t)、version(同 \-v)、extension(同
\-X)、width
.TP
\fB\-\-time\fP=\fI\,关键字\/\fP
改变使用的时间类型,默认为修改时间;访问时间(同 \fB\-u\fP):atime、access、use;变更时间(同
\fB\-c\fP):ctime、status;创建时间:birth、creation;
.IP
和 \-l 同时使用时,关键字 指定要显示的时间类型;和 \-\-sort=time 同时使用时,按照关键字进行排序(最新的最前)
.TP
\fB\-\-time\-style\fP=\fI\,时间风格\/\fP
使用 \fB\-l\fP 时显示的时间/日期格式;参见下面“时间风格”的相关内容
.TP
\fB\-t\fP
按时间排序,最新的最前;参见 \fB\-\-time\fP
.TP
\fB\-T\fP, \fB\-\-tabsize\fP=\fI\,列数\/\fP
指定制表符宽度为给定列数,而非默认的 8
.TP
\fB\-u\fP
与 \fB\-lt\fP 同时使用时:显示访问时间且按访问时间排序;与 \fB\-l\fP 同时使用时:显示访问时间但按名称排序;其他情况:按访问时间排序,最新的最前
.TP
\fB\-U\fP
不进行排序;按照目录顺序列出项目
.TP
\fB\-v\fP
对文本中的数字(或版本号)进行自然排序
.TP
\fB\-w\fP, \fB\-\-width\fP=\fI\,列数\/\fP
设置输出宽度为指定列数。0 表示无限制
.TP
\fB\-x\fP
逐行列出项目而不是逐列列出
.TP
\fB\-X\fP
按照扩展名的字母顺序排序
.TP
\fB\-Z\fP, \fB\-\-context\fP
输出每个文件的所有安全上下文信息
.TP
\fB\-\-zero\fP
以 NUL 字符而非换行结束每个输出行
.TP
\fB\-1\fP
每行只列出一个文件
.TP
\fB\-\-help\fP
显示此帮助信息并退出
.TP
\fB\-\-version\fP
显示版本信息并退出
.PP
大小的参数是一个整数,后面可以跟一个单位(例如:10K 指 10*1024)。可用的单位有 K、M、G、T、P、E、Z、Y(1024 的幂)以及
KB、MB、...(1000 的幂)。也可以使用二进制前缀:KiB=K、MiB=M,以此类推。
.PP
时间风格参数可以是 full\-iso、long\-iso、iso、locale,或者“+格式”。“格式”的解析方式同 \fBdate\fP(1)。如果“格式”是
格式1<换行符>格式2 的话,则 格式1 将应用于时间较久远的文件,格式2 将应用于时间较近的文件。“时间风格”如果带有
"posix\-" 前缀,则它只会在区域设置非 POSIX 时生效。另外,可以使用 TIME_STYLE 环境变量设置默认使用的风格。
.PP
“何时”参数的默认值是 "always",也可以设为 "auto" 或 "never"。
.PP
使用颜色来区分文件类型的功能默认禁用,也可以使用 \fB\-\-color\fP=\fI\,never\/\fP 禁用。若使用
\fB\-\-color\fP=\fI\,auto\/\fP 选项,ls 只在标准输出连接至终端时才生成颜色代码。LS_COLORS 环境变量可以改变颜色设置。可以使用
\fBdircolors\fP(1) 命令来设置它。
.SS 退出状态:
.TP
0
表示正常,
.TP
1
表示小问题(例如:无法访问子目录),
.TP
2
表示严重问题(例如:无法使用命令行参数)。
.SH 作者
由 Richard M. Stallman 和 David MacKenzie 编写。
.SH 报告错误
GNU coreutils 的在线帮助:
.br
请向 报告翻译错误。
.SH 版权
Copyright \(co 2022 Free Software Foundation, Inc. License GPLv3+: GNU GPL
version 3 or later .
.br
本软件是自由软件:您可以自由修改和重新发布它。在法律允许的范围内,不提供任何保证。
.SH 参见
\fBdircolors\fP(1)
.PP
.br
完整文档请见:
.br
或者在本地使用: info \(aq(coreutils) ls invocation\(aq
.SH "跋"
.br
本页面中文版由中文 man 手册页计划提供。
.br
中文 man 手册页计划:\fBhttps://github.com/man-pages-zh/manpages-zh\fR