dir命令存在于Debian GNU/Linux、AmigaDOS、TRS-DOS、RT-11、OpenVMS、TOPS-10、OS/8、CP/M系统、GEMDOS、MS-DOS、PC-DOS、DR-DOS、FreeDOS、Singularity、OS/2、Windows、ReactOS等操作系统中。

Debian GNU/Linux操作系统中的dir命令（区分大小写，dir命令全部字母小写），和ls -C -b效果相同。

语法：

以下是dir命令中的选项：

-a或--all

沿着两个分别显示当前和上一级目录为“.”和“..”的文件显示所有隐藏的文件（起始于“.”）。

语法：

-A或--almost-all

近似-a，不过不显示当前目录和上一个目录的文件。

语法：

-l --author

显示所有文件的作者。-l必须在一个列表的表格中显示目录。

-B或--ignore-backups

忽略备份文件的列表。这些文件以一个“~”结束。

语法：

--color

（可以由=[TIME]紧随其后）

被用于添加彩色到输出的文字。从可以自动规范时间的不在，从不或通常，添加彩色给通常输出的文字。（默认行为）

语法：

-F或--classify

增加标志（*/=＞@|符号之一）到分类的文件名。符号的含义如下：

/ 目录

* 可执行文件

@ 符号链接

% 修正

= 套接字

| FIFO

命令语法：

--file-type

和-F相同，不过不在可执行文件增加星号（*）。

命令语法：

--format=WORD

格式化条目的列表。WORD可以带着跟随的值：across、commas、horizontal、long、single-column、verbose、vertical。可以通过分别添加-x、-m、-x、-l、-1、-l、-C选项至dir命令中给各自的值。

命令语法：

--hide=PATTERN或--ignore=PATTERN

列出目录时忽略PATTERN的shell描述的文件。

命令语法：

-n或--numeric-uid-gid

近似生成长列表的-l，不过列出数字用户（英文：numeric user）和组标识（英文：group IDs）。

命令语法：

-r或--reverse

倒序列出文件。

命令语法：

-R或--recursive

递归地列出子目录。

命令语法：

--sort=PARAMETER

由PARAMETER分类列出文件。PARAMETER可以带着跟随的值：none（-U）、size（-S）、time（-t）、version（-v）、extension（-X）。不是通过-sort选项，括号中指示的标记（英文：flags indicated）可以直接以分类列表的选项作为通过。

命令语法：

--help

输出帮助选项并退出。

命令语法：

--version

输出版本信息并退出。

命令语法：

改变当前目录。

语法（RDOS）：

语法（DOS）：

DIR命令列出文件列表，命令不区分大小写。

以OS/8模拟程序WinEight示例：

DIR和DIRECT、DIRECTORY是同一条命令，该命令列出一个目录下的文件。

运行示例：

DIR和DIRECTORY是同一条命令。

DIR程序在指定的设备列表上列出目录信息，例如存储在设备上的文件的数量、名称和创建日期，甚至文件类型和文件大小。可以有不同的方法组织列表，按照字母顺序或按年表顺序列出目录。

命令语法：

命令中指定的日期[date]格式是[:dd][:mmm][:yy]。

这个命令生成用户指定的文件列表。指定仅一个输入设备。用户可在一个文件规范中使用通配符。默认的输出文件类型是.DIR。

以下是[/options]中可选的参数：

ALLOCATE:size

搭配/OUTPUT参数使用，保留空间给输出列表文件。

ALPHABETIZE

根据文件名称和类型的字母顺序排列文件。

BADBLOCKS

扫描设备的坏块（英文：bad blocks）并列出它们的八进制数。

BEFORE[date]

列出早于用户指定日期创建的文件。

BEGIN

从用户指定的文件开始列出文件。

BLOCKS

列出文件的起始块。

BRIEF或FAST

只列出文件的名称和类型。

COLUMNS:n

指定目录列出的列数。

DATE[date]

列出在用户指定的日期创建的文件。

DELETED

列出被删除的文件名的目录。

列出DOS-11操作系统或RSTS/E操作系统卷（英文：system volume）的目录。

END

指定坏块扫描的结束块（英语：ending block）。仅搭配/BADBLOCKS使用有效。

EXCLUDE

列出除了用户指定的文件的所有文件。

FILES

打印寻找到的坏块中的文件的名称。仅搭配/BADBLOCKS使用有效。

FREE

列出未曾使用的区域（英文：unused areas）。

FULL

列出整个目录，包括未曾使用的区域。

INTERCHANGE

列出一个交换格式化磁盘（英文：interchange format diskette）的目录。

NEWFILES

只列出当前系统日期的文件。

OCTAL

使用八进制列出文件大小和开始块数字。

ORDER或SORT

按照用户说明的类型件（category）排列文件。类型是：

NAME：按照文件名字母顺序排列文件。

TYPE：按照文件类型字母顺序排列。

SIZE：按照文件大小排列。

DATE：按照创建日期排列。

POSITION：按照文件在设备上的位置排列。

OUTPUT:filespec

输出目录列表至用户指定的文件中。

OWNER:[nnn,nnn]

说明目录的UIC被列出。仅搭配/DOS使用有效。

POSITION

列出在磁带上的文件的文件顺序编号。

PRINTER

在行打印机（英文：line printer）上打印目录。

REVERSE

保留在任何排序生效目录的顺序。

SINCE[date]

列出在用户请求的日期或晚于用户请求的日期创建的文件。

START:n

说明扫描坏块的起始块编号。仅搭配/BADBLOCKS使用有效。

SUMMARY

列出用户请求的目录的段结构（英文：segment structure）。

TERMINAL

在终端上列出目录。

TOPS

列出被DECsystem-10格式化的DECtape的目录。

VERIFY

读取、重写，然后重读所有坏块。仅搭配/BADBLOCKS使用有效。

VOLUMEID[:ONLY]

打印磁盘或磁带的卷号（英文：volume ID）和拥有者名称。如果:ONLY不存在，也列出目录。

WAIT

在开始操作之前等待用户答复。仅搭配/BADBLOCKS使用有效。当系统卷使用数据卷代替时必须使用。

以下是RT-11操作系统下运行DIR命令的示例：

DIR和DIRECTORY是同一条命令。

语法：

运行命令示例：

列出一个在线磁盘的目录中的非系统（DIR）文件。

示例：

列出目录（list directories）。该命令不分大小写。

命令语法：

运行示例：

DIR——显示磁盘目录命令

1．功能：显示磁盘目录的内容。

2．类型：内部命令

3．格式：

使用说明

/A

显示具有指定属性的文件。

属性：

D：目录

R：只读文件

H：隐藏文件 A：准备存档的文件

S：系统文件 I：无内容索引文件

L：解析点 - 表示“否”的前缀

/B

使用空格式（没有标题信息或摘要）。

/C

在文件大小中显示千位分隔符。这是默认值。用/-C来禁用分隔符显示。

/D

跟宽式相同，但文件是按栏分类列出的。

/L

用小写。

/N

新的长列表格式，其中文件名在最右边。

/O

用分类顺序列出文件。

排列顺序：

N：按名称（字母顺序）

S：按大小（从小到大）

E：按扩展名（字母顺序）

D：按日期/时间（从先到后）

G：组目录优先 - 反转顺序的前缀

/P

在每个信息屏幕后暂停。

/Q

显示文件所有者。

/R

显示文件的备用数据流。

/S

显示指定目录和所有子目录中的文件。

/T

控制显示或用来分类的时间字符域。

时间段：

C：创建时间

A：上次访问时间

W：上次写入的时间

/W

用宽列表格式。

/X

显示为非8.3命名规则产生的短名称。格式是/N的格式，短名称插在长名称前面。如果没有短名称，在其位置则显示空白。

/4

用4位数字显示年

可以在DIRCMD环境变量中预先设定开关。通过添加前缀-（破折号）来替代预先设定的开关。例如“/-W”。

DIR X:/A:D：只显示X盘下所有的目录

DIR X:/A:-D：只显示X盘下所有的文件

如果不写盘符，默认为当前目录

类成员一

返回值：

添加到列表中的上一个文件名称的基于零的索引。如果出错，则返回LB_ERR;如果没有足够有效空间存储新字符串，则返回LB_ERRSPACE。

参数：attr可以是CFile::GetStatus中描述的枚举值的组合，或下列值的组合：值含义

0x0000：可读取或写入的文件

0x0001：可读取但不可写入的文件

0x0002：隐藏文件，不在目录列表中出现

0x0004：系统文件

0x0010：由lpszWildCard指定的名字，指定一个目录

0x0020：已归档的文件

0x4000：包括匹配由lpszWildCard确定的名字的所有驱动器

lpszWildCard：指向文件说明字符串的指针。此字符串可包含通配符。

说明：添加文件名称和/或驱动器列表到列表框中。

请参阅：CWnd::DlgDirList,LB_DIR,CFile::GetStatus

类成员二

返回值：

大于等于0时，是添加到列表最后的文件名的下标。出错时返回CB_ERROR；没有足够的空间存放新的字符串时返回CB_ERRSPACE。

参数： attr可以是CFile::GetStatus中定义的枚举值的组合或以下值的组合： · DDL_READWRITE 文件可以读写。

· DDL_READONLY：文件只读。

· DDL_HIDDEN：隐藏文件，在目录列表中看不到。

· DDL_SYSTEM：系统文件。

· DDL_DIRECTORY：lpszWildCard指定的名字是一个目录。

· DDL_ARCHIVE：档案文件。

· DDL_DRIVES：包括所有匹配lpszWildCard指定的名字的驱动器。

· DDL_EXCLUSIVE：独占标志。如果置了独占标志，则只列出指定的文件；否则指定的文件在正常文件之后与之一起列出。

lpszWildCard：指向一个指定文件名的字符串。字符串中可以包括通配符（例如*.*）。

说明：

在组合框的列表中增添文件名的列表或者驱动器列表。

语法：

路径：

指定要列出的驱动器、目录和/或文件。

/A

显示具有指定属性的文件。

attributes

D：目录

R：只读文件

H：隐藏文件

A：准备存档的文件

S：系统文件——表示“否”的前缀

/B

使用空格式（没有标题信息或摘要）。

/C

在文件大小中显示千位数分隔符。这是默认值。用/-C来停用分隔符显示。

/D

跟宽式相同，但文件是按栏分类列出的。

/L

用小写。

/N

新的长列表格式，其中文件名在最右边。

/O

用分类顺序列出文件。

sortorder

N：按名称（字母顺序）

S：按大小（从小到大）

E：按扩展名（字母顺序）

D：按日期/时间（从先到后）

G：组目录优先——颠倒顺序的前缀

/P

在每个信息屏幕后暂停。

/Q

显示文件所有者。

/S

显示指定目录和所有子目录中的文件。

/T

控制显示或用来分类的时间字符域。

timefield

C：创建时间

A：上次访问时间

W：上次写入的时间

/W

用宽列表格式。

/X

显示为非8.3命名规则产生的短名称。格式是/N的格式，短名称插在长名称前面。如果没有短名称，在其位置则显示空白。

/4

用四位数字显示年份。

/?

在命令提示符下显示帮助。

可以在DIRCMD环境变量中预先设定开关。通过添加前缀-（破折号）来替代预先设定的开关。例如“/-W”。

注释

可以使用多个FileName参数。用空格、逗号或分号隔开文件名。可以在FileName中使用通配符（?和*）来显示一组文件。

可以使用通配符，如星号（*）或问号 （?），来代表文件名的一个或多个字符，以显示文件的子集或子目录。

星号（*）：可使用星号代替任何字符串。例如，键入：

列出当前目录中所有具有以“.TXT”开头（如 .TXT、.TXT1、.TXT_OLD）的扩展名的文件。

列出当前目录中所有以“READ”开头而且扩展名以“.TXT”开头（如 .TXT、.TXT1、.TXT_OLD）的文件。

列出当前目录中带有任意扩展名的以“READ”开头的所有文件。

切记，星号通配符总是使用短文件名映射，因此，您可能会得到意外的结果。例如，下面的目录包含2个文件，T.TXT2和T97.TXT：

您可能认为键入DIR T97*会返回文件T97.TXT。然而，键入DIR T97*将返回两个文件，这是因为，星号（*）通配符使用其短名称映射T97B4~1.TXT将文件T.TXT2匹配到T97.TXT。类似地，键入DEL T97*将删除这两个文件。

问号（?）：使用问号代替名称中的单个字符。例如，键入：

列出当前目录中所有带有“.TXT”扩展名而且以“READ”开头并且后面最多跟3个字符的文件，包括READ.TXT、READ1.TXT、READ12.TXT、READ123.TXT和README1.TXT，但是不包括README12.TXT。

指定文件显示属性

如果使用其Attributes中指定多个值的“/A”，则DIR只显示那些带有所有指定属性的文件的名称。例如，如果使用“/A:R-H”或“/AR-H”指定“/A”，并以R和“-H”作为属性，则DIR只显示非隐藏的只读文件的名称。

指定文件名排序

如果指定了多个SortOrder值，DIR首先通过第一个标准对文件名进行排序，然后再通过第二个标准排序，以此类推。例如，如果使用“/O:E-S”或“/OE-S”指定“/O”，并以“E”和“-S”作为SortOrder的值，则DIR将根据扩展名对目录名和文件名从大到小进行排序，然后显示最终结果。按照扩展名字母顺序排序使得没有扩展名的文件名最先显示，目录名次之，然后是具有扩展名的文件名。

? 使用重定向符号和管线

在使用重定向符号（>）将DIR输出发送到文件，或者使用管线（|）将DIR输出发送到其他命令时，请使用“/A:-D”和“/B”只列出文件名。可以使用FileName以及“/B”和“/S”来指定DIR在当前目录及其子目录中搜索所有匹配FileName的文件名。DIR对查找到的每个文件名只列出其驱动器号、目录名、文件名和文件扩展名、每行一个路径。在使用管线重定向之前，应该在AUTOEXEC.NT文件中设置TEMP环境变量。

使用重定向符号输出示例：

则表示将搜索到的结果保存到FILEINFO.TXT文件中

? 预置DIR参数

通过将带有DIRCMD环境变量的SET命令包含在AUTOEXEC.NT文件中，可以预置DIR参数。可以在SET DIRCMD中使用DIR参数的任意有效组合，其中包括文件的位置和名称。

例如，要使用DIRCMD环境变量将宽行显示格式（即 /W）设置为默认格式，请在AUTOEXEC.NT文件中键入以下命令：

对于DIR命令的单次使用，您可以用DIRCMD环境变量来覆盖某个参数。为此，请在DIR命令提示符下键入要覆盖的参数,并在参数前面加上减号。例如：

要更改DIRCMD默认设置，请键入：

新的默认设置对所有后接的DIR命令有效，直到再次使用SET DIRCMD或重新启动计算机时为止。

要清除所有默认设置，请键入：

要查看DIRCMD环境变量的当前设置，请键入：

SET显示环境变量及其设置的列表。有关设置环境变量的详细信息，请参阅“相关主题”。

? 从“恢复控制台”可以使用包含各种参数的DIR命令。

示例

要按字母顺序以宽格式一个接一个地显示所有目录，并在显示出每个屏幕后暂停一下，请确保根目录是当前目录，然后键入：

DIR列出根目录的名称、根目录的子目录名称和根目录中文件的名称（包括扩展名）。然后，DIR列出该目录树中每个子目录包含的子目录名和文件名。

要更改前面的示例，使DIR显示文件名和扩展名而省略目录名，请键入：

要打印目录列表，请键入：

指定PRN时，目录列表发送到与LPT1端口相连接的打印机上。如果打印机连接在其他端口上，则必须使用正确端口的名称替换PRN。

也可以通过用文件名替换PRN，将DIR命令的输出重定向到文件。还可以键入路径。例如，要将DIR输出定向到RECORDS目录的DIR.DOC文件中，请键入：

如果DIR.DOC不存在，DIR将创建该文件，除非Records目录也不存在。在这种情况下，会出现如下消息：

要显示驱动器C上所有目录中带“.TXT”扩展名的所有文件名的列表，请键入：

DIR以宽格式按字母顺序显示每个目录中匹配文件名的列表，而且每次满屏时暂停，直到您按键继续。

dir是Get-ChildItem的别名。

Get-ChildItem

gci、ls、dir