---
source_url: https://docs.dolphindb.cn/zh/funcs/r/rmdir.html
fetched_at: 2026-05-19T09:36:36Z
category: funcs
title: rmdir
sha1: 036986229a5ce51ccc72fce1d255fea14b6dd30c
---

# rmdir

## 语法

`rmdir(directory,
[recursive=false],
[keepRootDir=false])`

## 详情

删除目录。默认情况下，要删除的目录必须为空。如果目录不为空仍然要删除它时，请设置 *recursive*
的值为true。

注：

该命令在用户登录后才能执行。

## 参数

**directory** 必备参数，用于指定要删除的文件夹名称。如果该目录不为空，则通过设定 *recursive* 的值为 true
可以删除所有子目录和文件

**recursive** 布尔值，可选参数，用于是否删除所有指定文件夹所有子目录及其中文件。默认值为 false。

**keepRootDir** 布尔值，可选参数，用于指定是否保留根目录。默认值为 false。当设置为 true
时，仅删除子目录和文件，而不会删除根目录。

注：

若设置
*keepRootDir*=true，则必须设置 *recursive*=true。

## 例子

```dolphindb
files("/home/test");
```

| filename | isDir | fileSize | lastAccessed | lastModified |
| --- | --- | --- | --- | --- |
| dir1 | 1 | 0 | 2024.04.03 01:31:48.367 | 2024.04.03 01:31:48.367 |
| dir2 | 1 | 0 | 2024.04.03 01:36:43.982 | 2024.04.03 01:36:43.982 |
| dir3 | 1 | 0 | 2024.04.03 01:37:45.618 | 2024.04.03 01:37:45.618 |

```dolphindb
// delete a directory. dir1 is empty, dir2 is not empty.
rmdir("/home/test/dir1");
rmdir("/home/test/dir2");
// output
Failed to remove directory [/home/test/dir2] with error code 145

// Delete a directory recursively
rmdir("/home/test/dir2", true);

files("/home/test");
```

| filename | isDir | fileSize | lastAccessed | lastModified |
| --- | --- | --- | --- | --- |
| dir3 | 1 | 0 | 2024.04.03 01:37:45.618 | 2024.04.03 01:37:45.618 |
