LS(1)

名稱
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