| LS(1) | 使用者命令 | LS(1) |
名稱¶
ls - 列出目錄內容
概述¶
ls [選項]... [檔案列表]...
描述¶
列出指定“檔案”（預設為當前目錄）的資訊。如果既沒有指定 -cftuvSUX 中任何一個，也沒有指定 --sort，則按字母排序專案。
必選引數對長短選項同時適用。
- -a, --all
- 不要忽略以點號（“.”）起始的條目
- -A, --almost-all
- 不要列出隱含的 . 和 ..
- 與 -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
| 2022年9月 | GNU coreutils 9.1 |