# Node.js 如何读取目录文件列表

URL: https://caijiao.org/how-to/javascript/node-list-directory
Source: docs/how-to/javascript/node-list-directory.md
Description: Node.js 如何读取目录文件列表：用 readdir 读取目录，传 withFileTypes 可以区分文件和目录。 示例可直接复制到浏览器或项目代码中，并附相关教程、工具入口。

## 快速答案

用 readdir 读取目录，传 withFileTypes 可以区分文件和目录。

```js
import { readdir } from 'node:fs/promises';
const entries = await readdir('docs', { withFileTypes: true });
```

## 使用要点

- Node 和 Vite 示例要确认当前运行目录、环境变量前缀和操作系统差异。
- 脚本写文件、执行命令或读取路径前，先打印一次目标路径便于排查。

## 相关内容

- [JavaScript / TypeScript 问题](/how-to/javascript/)
- [JavaScript 教程](/javascript/)
- [TypeScript 教程](/ts/)
- [JSON Formatter](/tool/json-formatter)
- [JSON Validator](/tool/json-validator)