dir

按深度、掩码、过滤条件、排序、元数据和汇总显示目录树。

文件版本 1.2.4稳定
lil-terminal

概览

当 cd 的平面视图不够用时使用 dir：可以设置深度、掩码、文件或目录过滤、分组、排序和汇总，而不依赖系统的 ls 或 find。

有目的地读取目录结构

深度、掩码和排序可以把大型目录树变成一个具体问题：这里有什么、位于哪里、哪些条目真正重要？

语法

lil-terminal
dir [depth] [path] [mask] [options]

参考

dir | dir 1

显示当前目录的一层树

dir 0 [path]

显示平面列表

dir <depth> [path]

显示到所选深度的目录树

dir -R [path]

递归显示目录树

dir [path] <mask>

显示匹配文件以及访问它们所需的父目录

-F | -f

仅目录 | 仅文件

-p

显示完整路径

-G | -g

目录优先 | 文件优先

-sum

显示目录、文件、链接和大小总计

-a | -A

按名称升序 | 降序

-e | -E

按扩展名升序 | 降序

-d | -D

按修改时间升序 | 降序

-s | -S

按大小升序 | 降序

-u

显示文件系统所有者

列与排序

所有选项都以 - 开头。每组排序参数中，小写参数按升序排列，对应的大写参数按降序排列。-d/-D 同时显示修改时间，-s/-S 显示大小，-u 添加文件系统所有者。元数据紧挨名称或树节点之前并在左侧保持紧凑，名称或路径使用其余宽度。

过滤与掩码

-F 只保留真实目录，-f 只保留普通文件；符号链接始终作为独立类型处理。"*.php" 之类的掩码会过滤文件，同时保留用于说明匹配位置所必需的父目录。-p 会把显示名称展开为完整的 lil-terminal 路径。

限制

深度限制为20，每次最多扫描5000项；不会递归跟随符号链接目录。

交互式 sandbox 预览

可直接在页面中运行预先准备的示例。结果已预先生成并在浏览器中显示；服务器不会执行任何终端命令。

显示到所选深度的目录树

安装与管理

安装当前兼容版本。完整功能请选择 Base，精简包请选择 Minimum；已安装模块的更新请使用 upgrade。

Base 与 Minimum 是同一当前模块版本的两个包。

Base 包

安装包含本地参考和全部已发布模式的完整包。

install dir
Minimum 包

安装精简包。该包不包含本地参考；help <cmd> -i 会打开当前服务器参考。

install dir -m
精确公开版本

安装这个确切的已发布版本。

install dir -v 1.2.4
检查或升级

让 upgrade 检查兼容性，仅在需要时替换已安装块。

upgrade dir
删除模块

删除扩展块，不影响核心和其他模块。

install dir -u

示例

示例可复制，但网站不会执行。请先检查路径、权限和破坏性选项。

显示到所选深度的目录树
cd \sandbox | dir 2 . -G -a
archives
config
  .env.example
  app.ini
  app.json
data
  sample.csv
  sample.txt
  users.json
显示完整路径
dir 0 \sandbox -p
/sandbox/archives
/sandbox/config
/sandbox/data
/sandbox/feed.xml
/sandbox/images
显示匹配文件以及访问它们所需的父目录
dir 3 \sandbox "*.php" -G
src
  Calculator.php
  index.php
scripts
  task.py
仅目录 | 仅文件
dir 2 \sandbox -F
archives
config
data
db
images
logs
public
scripts
tmp
workspace
按扩展名升序 | 降序
dir 2 \sandbox -f -e
README.txt
feed.xml
new.txt
test.txt
按修改时间升序 | 降序
dir 2 \sandbox -d
2026-08-04 23:20:34    archives
2026-08-08 23:20:40    config
2026-08-08 20:18:28    new.txt
按大小升序 | 降序
dir 2 \sandbox -S
 39 KB    123.jpg.tar
37.4 KB    123.jpg
1.3 KB    feed.xml
显示文件系统所有者
dir 1 \sandbox -u
www-data    archives
www-data    config
www-data    feed.xml
显示目录、文件、链接和大小总计
dir 2 \sandbox -sum
archives
config
data
...

目录数  10
文件  18
链接  0
大小  44.2 KB
仅目录 | 仅文件
dir 2 \sandbox -F -f
过滤器冲突

本示例使用的文件: sandbox/README.txt

该示例使用受保护的 /sandbox/ 文档工作区中的文件或目录。

lil-terminal documentation sandbox

This directory is part of the server tree: website_e36e9fed/sandbox/.
It is never included in generated lil-terminal downloads and direct HTTP access is blocked.
The documentation renderer reads only explicitly allow-listed files from here and
uses them to show real, reproducible command examples.

The fixtures are intentionally small and contain no secrets. They cover PHP, HTML,
CSS, JavaScript, JSON, INI, SQL, Python, shell, XML/SVG, CSV, plain text, logs,
images, .lil workflows, archives and temporary work paths.

During module review, examples may be refined together with the command. Keep paths
stable whenever possible because public documentation links refer to them.

相关文档

文件系统操作如何受到保护？ →为什么大文件和大量输出会受限制？ →

当前公开版本

v1.2.42026-08-13

更易读的元数据

扩大名称列前的间距并对齐紧凑的字节大小，同时保持标准单位 B、KB、MB、GB 和 TB。

# 版本历史