读取文本文件内容

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

功能描述

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

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

语法

=f_读取文本文件(文件路径)

参数

参数名	类型	必填	默认值	说明
文件路径	String	是	无	待读取文本文件的完整路径

返回值

String - 文件的全部文本内容。异常时返回 "错误: {异常信息}"。

使用示例

读取文本文件内容

公式：

=f_读取文本文件("D:\Data\notes.txt")

结果：

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

文件不存在

公式：

=f_读取文本文件("C:\nofile.txt")

结果：

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

获取文件内容长度

公式：

=LEN(f_读取文本文件(A1))

结果：

128

技术说明

• 调用 File.ReadAllText(filePath) 一次性读取整个文件的文本内容。
• 自动检测文件编码（UTF-8 或系统默认编码）。
• 适用于文本格式文件（如 .txt、.csv、.json、.xml 等），不适合二进制文件。

错误处理

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