写入文本到文件

函数名：f_写入文本文件 / f_Write

功能描述

将指定文本内容写入目标文件，支持覆盖写入和追加写入两种模式。

会员等级：🟢 免费版（Free）

语法

=f_写入文本文件(文件路径, 内容, 追加模式)

参数

参数名	类型	必填	默认值	说明
文件路径	String	是	无	待写入文件的完整路径
内容	String	是	无	要写入的文本内容
追加模式	Boolean	否	FALSE	TRUE=追加到文件末尾，FALSE=覆盖原文件内容

返回值

String - 操作结果字符串。成功返回 "写入成功"，异常返回 "错误: {异常信息}"。

使用示例

覆盖写入文本

公式：

=f_写入文本文件("D:\Data\log.txt", "日志内容：开始运行", FALSE)

结果：

写入成功

追加写入文本

公式：

=f_写入文本文件("D:\Data\log.txt", "新增日志条目", TRUE)

结果：

写入成功

追加带时间戳的日志

公式：

=f_写入文本文件("D:\Data\log.txt", TEXT(NOW(), "yyyy-MM-dd HH:mm:ss") & " - 执行成功" & CHAR(10), TRUE)

结果：

写入成功

技术说明

• 当 追加模式 为 TRUE 时，调用 File.AppendAllText 将内容追加到文件末尾。
• 当 追加模式 为 FALSE（默认）时，调用 File.WriteAllText 覆盖写入整个文件。
• 若目标文件不存在，两种模式均会自动创建文件。
• 若目标路径的父目录不存在，将触发异常。

错误处理

错误场景	返回值
父目录不存在	错误: 找不到路径。
权限不足	错误: 拒绝访问。
文件被占用	错误: 文件正由另一进程使用。
其他异常	错误: {异常信息}