# fs.write

## 功能

覆盖写入文件内容。

## 语法

```bt
fs(path).write(content)
```

## 参数

| 参数 | 类型 | 必填 | 默认值 | 说明 |
| ------ | ------ | ------ | ------ | ------ |
| content | Any | 否 | '' | 要写入的内容；数组和对象会写入 JSON 字符串。 |

## 返回值

| 类型 | 说明 |
| ------ | ------ |
| Int | 返回写入字节数。 |

## 示例

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

// 输出：2
print result
```

## 注意事项

- 会覆盖已有文件内容。
- 父目录不存在时由底层文件写入规则决定是否报错。