名稱

       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