f_Delete函数

函数名：wj_删除文件 / f_Delete

函数功能

删除指定路径的文件，支持强制删除只读文件，并返回操作状态信息。

参数规范

参数名	类型	必填	示例	特殊说明
filePath	String	是	"C:\temp\file.txt"	目标文件完整路径
forceReadOnly	Boolean	否	TRUE	是否强制删除只读文件，默认FALSE

使用案例

3.1 普通文件删除

问题描述：删除指定路径的文件 公式演示：

=f_Delete("D:\Docs\report.docx")

输出效果：

删除成功

3.2 强制删除只读文件

问题描述：删除带只读属性的文件 公式演示：

=f_Delete("D:\Docs\readonly.txt", TRUE)

输出效果：

删除成功

3.3 文件不存在情况

问题描述：删除不存在的文件 公式演示：

=f_Delete("D:\Docs\nofile.txt")

输出效果：

文件不存在

3.4 权限不足提示

问题描述：无权限删除时提示并建议使用强制参数 公式演示：

=f_Delete("C:\System\protected.sys")

输出效果：

错误：权限不足（尝试启用强制只读参数）

技术说明

4.1 逻辑说明

• 检查文件是否存在
• 根据forceReadOnly参数，移除只读属性
• 删除文件并验证是否成功删除
• 捕获权限不足及其他异常，返回对应错误信息

4.2 异常处理

错误场景	返回值
文件不存在	文件不存在
权限不足	错误：权限不足（尝试启用强制只读参数）
其他异常	错误：{异常信息}

扩展应用

6.1 自动清理脚本

结合目录遍历批量删除符合条件的文件。

6.2 文件属性管理

配合强制参数删除只读文件，适合自动化管理受保护文件。

注：本函数在WPS 2019+和Excel 365中测试通过