首页 › FFReader使用手册

快速开始

FFReader是一款通用的接口数据文件解析阅读编辑工具，本手册将帮助您快速掌握FFReader的基本使用方法

安装与启动

  • Windows用户：下载后解压压缩包，双击运行FFReader.exe即可
  • macOS用户：下载后解压，双击FFReader.app运行
  • Linux用户：下载后解压，通过终端运行./FFReader或创建桌面快捷方式

基本功能介绍

文件解析

FFReader支持三种文件类型的解析：

  • OFD文件：基金行业广泛使用的字段定长文件
  • 通用字段定长文件：自定义字段长度的固定格式文件
  • 通用固定分隔符文件：CSV、TXT等使用分隔符的文件

打开文件时，FFReader会自动识别文件类型，也可以手动选择解析配置

数据浏览

解析后的数据以表格形式展示，支持：

  • 列模式显示 - 可单独查看某一列的数据
  • 字典翻译 - 显示枚举字段的翻译值
  • 字段详情 - 查看每个字段的详细信息
  • 按行/按单元格高亮 - 自定义高亮显示方式

数据搜索

强大的搜索功能支持：

  • 全文搜索 - 在整个文件中搜索关键词
  • 列搜索 - 在指定列中搜索
  • 特殊字符搜索 - 可搜索空格、制表符、零宽空格等不可见字符
  • 正则表达式搜索 - 支持高级正则匹配

数据编辑

支持对解析数据进行编辑操作：

  • 修改字段值
  • 添加新记录
  • 删除记录
  • 字段定长文件完整支持增删改操作

数据导出

可将解析后的数据导出为多种格式：

  • Excel格式：.xlsx文件，方便进一步分析
  • HTML格式：网页格式，便于分享查看
  • CSV格式：逗号分隔文件，通用性强

高级功能

文件比对

V1.11.5版本新增文件比对功能，可实现比常规文件比对软件更方便的数据接口级别的比对（依赖配置主键），该功能适合对比两份接口数据文件的差异

主键冲突检查

可检查文件中是否存在主键冲突数据，并可自由配置主键字段，帮助发现数据异常

字段必填校验

支持配置字段必填规则，检查数据是否符合业务规范要求

从压缩包解析

支持从压缩包中选择文件后自动解压并解析，方便查看压缩的接口文件

生僻字支持

FFReader支持GB18030-2022编码规范解析，支持到Level3等级，可正确处理生僻汉字，如需处理生僻字场景，建议下载生僻字测试补充说明包

字体设置

可自定义软件界面字体样式和大小，适应不同的显示需求

配置说明

FFReader采用主程序和配置分离的方式，配置文件位于程序包的conf目录下：

  • A_配置说明_配置前必读.txt：配置说明文档
  • 接口配置文件：定义各种接口的字段解析规则
  • 字典配置文件：定义字段值翻译映射

升级版本时，请保留自己本地配置的私有接口解析规则，复制到新版本程序包的conf目录下

常见问题

文件无法正确解析？

请检查：

  • 文件编码是否正确（支持UTF-8、GBK、GB18030等多种编码）
  • 文件格式是否与选择的解析配置匹配
  • 换行符是否正确（支持CR、CRLF、LF三种换行符）

生僻字显示为方块？

可能原因：

  • 操作系统字库版本过低，建议升级操作系统
  • 系统缺少相应字体，可从新版本操作系统复制字体安装
  • 建议下载生僻字测试补充说明包并按指引操作

导出Excel数值精度丢失？

如数值长度超过16位，Excel会存在精度丢失问题，建议使用V1.9.26及以上版本，已修复此问题

技术支持

如遇到问题或需要反馈bug，可通过以下方式联系：