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