.\" 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 的在线帮助： <https://www.gnu.org/software/coreutils/>
.br
请向 <https://translationproject.org/team/zh_CN.html> 报告翻译错误。
.SH 版权
Copyright \(co 2022 Free Software Foundation, Inc.  License GPLv3+: GNU GPL
version 3 or later <https://gnu.org/licenses/gpl.html>.
.br
本软件是自由软件：您可以自由修改和重新发布它。在法律允许的范围内，不提供任何保证。
.SH 参见
\fBdircolors\fP(1)
.PP
.br
完整文档请见： <https://www.gnu.org/software/coreutils/ls>
.br
或者在本地使用： info \(aq(coreutils) ls invocation\(aq
.SH "跋"
.br
本页面中文版由中文 man 手册页计划提供。
.br
中文 man 手册页计划：\fBhttps://github.com/man-pages-zh/manpages-zh\fR