# fs.rename

## 功能

把当前路径重命名为目标路径。

## 语法

```bt
fs(path).rename(to)
```

## 参数

| 参数 | 类型 | 必填 | 默认值 | 说明 |
| ------ | ------ | ------ | ------ | ------ |
| to | String | 是 | 无 | 目标路径。 |

## 返回值

| 类型 | 说明 |
| ------ | ------ |
| Fs | 返回绑定到新路径的 fs 对象。 |

## 示例

```bt
file = fs('docs-old.txt')
file.write('BT')
result = file.rename('docs-new.txt')

// 输出：Fs
echo(type(result))
```

## 注意事项

- 该方法会移动或重命名底层文件系统路径。