f_Read函数

函数名：wj_读取文本文件 / f_Read

函数功能

读取指定路径的文本文件内容，返回完整文本字符串。

参数规范

参数名	类型	必填	示例	特殊说明
filePath	String	是	"C:\\Users\\user\\Documents\\example.txt"	需提供文件的完整路径

使用案例

3.1 读取文本文件内容

问题描述：获取文本文件中的全部内容 公式演示：

=f_Read("D:\\Data\\notes.txt")

输出效果（示例）：

这是文本文件中的所有内容。

3.2 文件路径错误或读取失败

问题描述：读取不存在或无权限访问的文件 公式演示：

=f_Read("C:\\nofile.txt")

输出效果（示例）：

错误: 系统找不到指定的文件。

技术说明

4.1 读取逻辑

• 使用 File.ReadAllText() 读取整个文件文本
• 异常捕获返回错误信息字符串，方便定位问题

4.2 异常处理

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

扩展应用

6.1 结合文本处理函数

=LEN(f_Read(A1))  // 获取文件内容长度

6.2 读取并统计文件内容

=str_CountChar(f_Read(A1))  // 统计文件内容中的字符类型

注：本函数仅支持文本格式文件，适用于WPS及Excel，路径需正确且程序有读取权限。