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