Man page - ls(1)

Packages contains this manual

Available languages:

en fr pt_BR es pl vi nb ko nl da cs tr hu sv ja uk fi ru ro zh_TW sr zh_CN de

Manual

LS

名 稱
概 述
描 述
退 出 狀 態 ：
作 者
報 告 錯 誤
版 權
參 見
跋

名 稱

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