fs.write(fd, string[, position[, encoding]], callback)

版本历史

版本	变更
v19.0.0	不再支持将具有自己的 `toString` 函数的对象传递给 `string` 参数。
v17.8.0	不推荐将具有自己的 `toString` 函数的对象传给 `string` 参数。
v14.12.0	参数 `string` 将使用显式 `toString` 函数对对象进行字符串化。
v14.0.0	参数 `string` 不会再将不支持的输入强制转换为字符串。
v10.0.0	参数 `callback` 不再是可选的。不传入它会在运行时抛出 `TypeError`。
v7.2.0	参数 `position` 现在是可选的。
v7.0.0	参数 `callback` 不再是可选的。不传入它将触发 ID 为 DEP0013 的弃用警告。
v0.11.5	新增于: v0.11.5

fd <integer>
string <string>
position <integer> | <null> 默认值：null

¥position <integer> | <null> Default: null
encoding <string> 默认值：'utf8'

¥encoding <string> Default: 'utf8'
callback <Function>
- err <Error>
- written <integer>
- string <string>

将 string 写入 fd 指定的文件。如果 string 不是字符串，则抛出异常。

¥Write string to the file specified by fd. If string is not a string, an exception is thrown.

position 指从文件开头数据应被写入的偏移量。如果 typeof position !== 'number'，则数据将写入当前位置。请参见 pwrite(2)。

¥position refers to the offset from the beginning of the file where this data should be written. If typeof position !== 'number' the data will be written at the current position. See pwrite(2).

encoding 是预期的字符串编码。

¥encoding is the expected string encoding.

回调将接收参数 (err, written, string)，其中 written 指定传递的字符串需要写入多少字节。写入的字节数不一定与写入的字符串字符数相同。参见 Buffer.byteLength。

¥The callback will receive the arguments (err, written, string) where written specifies how many bytes the passed string required to be written. Bytes written is not necessarily the same as string characters written. See Buffer.byteLength.

在同一个文件上多次使用 fs.write() 而不等待回调是不安全的。对于这种情况，建议使用 fs.createWriteStream()。

¥It is unsafe to use fs.write() multiple times on the same file without waiting for the callback. For this scenario, fs.createWriteStream() is recommended.

在 Linux 上，以追加模式打开文件时，位置写入不起作用。内核会忽略位置参数，并始终将数据追加到文件末尾。

¥On Linux, positional writes don't work when the file is opened in append mode. The kernel ignores the position argument and always appends the data to the end of the file.

在 Windows 上，如果文件描述符连接到控制台（例如 fd == 1 或 stdout），则默认情况下无论使用何种编码，都无法正确渲染包含非 ASCII 字符的字符串。通过使用 chcp 65001 命令更改激活的代码页，可以将控制台配置为可正确渲染 UTF-8。有关详细信息，请参阅 chcp 文档。

¥On Windows, if the file descriptor is connected to the console (e.g. fd == 1 or stdout) a string containing non-ASCII characters will not be rendered properly by default, regardless of the encoding used. It is possible to configure the console to render UTF-8 properly by changing the active codepage with the chcp 65001 command. See the chcp docs for more details.