---
title: ls - 目录列表
description: 列出目录内容
---

列出目录内容，按字母排序，目录名带 `/` 后缀，包含隐藏文件。

## 依赖

无额外依赖，默认可用。

## 参数

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `path` | string | 是 | 目录路径，相对路径基于工作空间目录 |
| `limit` | integer | 否 | 最大返回条目数，默认 500 |

## 使用场景

- 浏览项目结构
- 查找特定文件
- 检查目录是否存在
