.\" 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