f_Write函数

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

函数功能

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

参数规范

参数名	类型	必填	示例	特殊说明
filePath	String	是	"C:\\Users\\user\\Documents\\output.txt"	目标文件的完整路径
content	String	是	"这是要写入的文本内容"	需要写入的文本内容
append	Boolean	否	TRUE	是否追加写入，默认覆盖写入

使用案例

3.1 覆盖写入文本

问题描述：将文本覆盖写入文件 公式演示：

=f_Write("D:\\Data\\log.txt", "日志内容：开始运行", FALSE)

输出效果：

写入成功

3.2 追加写入文本

问题描述：在文件末尾追加文本 公式演示：

=f_Write("D:\\Data\\log.txt", "新增日志条目", TRUE)

输出效果：

写入成功

3.3 异常处理示例

问题描述：写入路径不存在或权限不足 公式演示：

=f_Write("C:\\readonly\\file.txt", "测试内容")

输出效果（示例）：

错误: 拒绝访问。

技术说明

4.1 写入逻辑

• append为TRUE时，调用 File.AppendAllText() 追加内容
• append为FALSE或缺省时，调用 File.WriteAllText() 覆盖写入
• 捕获异常返回错误信息字符串，便于排查问题

4.2 异常处理

错误场景	返回内容示例
路径不存在	"错误: 找不到路径。"
权限不足	"错误: 拒绝访问。"
其他异常	返回对应异常信息字符串

扩展应用

6.1 日志文件维护

=f_Write("log.txt", "运行日志：" & TEXT(NOW(), "yyyy-mm-dd hh:mm:ss") & " - 执行成功", TRUE)

追加日志时间戳

6.2 文件写入后读取验证

=f_Read("log.txt")

读取刚写入的文件内容确认

注：确保路径正确且有写入权限，文本文件建议使用UTF-8编码以避免乱码问题。