# fs.read

## 功能

读取文本文件内容。

## 语法

```bt
fs(path).read()
```

## 参数

无参数。

## 返回值

| 类型 | 说明 |
| ------ | ------ |
| String | 返回文件 UTF-8 文本内容。 |

## 示例

```bt
file = fs('docs-read.txt')
file.write('BT')
result = file.read()

// 输出：BT
print result
```

## 注意事项

- 读取失败时抛出中文错误。
- 该方法按 UTF-8 文本读取。