如何区分PDF单选框中用户添加与Adobe自动生成的"Off"选项？

先搞懂为什么会出现这个"Off" #

PDF单选按钮组的底层机制是：当组内没有任何选项被选中时，会默认返回"Off"作为状态值。如果你的单选组选项是"On"/"Off"，这个默认值刚好和其中一个选项的导出值重合，所以看起来只有两个选项；但如果是"Yes"/"No"这类选项，默认的"Off"就会被单独列出来，显得是多余的选项。

怎么判断"Off"是自动生成还是表单原有？ #

• 用Acrobat Pro这类专业PDF编辑器打开原表单，找到对应的单选按钮组，查看每个选项的导出值（Export Value）。如果没有任何一个选项的导出值是"Off"，那dump出来的"Off"就是pdftk自动生成的默认未选中状态值。
• 查看pdftk [PDF file] dump_data_fields的输出细节：自动生成的"Off"不会对应表单里的实际按钮控件，通常只有FieldStateOption: Off这一行；而真实的表单选项会附带更多关联信息（比如FieldName带按钮标识、有FieldAltText等）。

怎么去掉这个自动添加的"Off"？ #

pdftk本身没办法直接阻止输出这个默认的"Off"，只能在获取结果后手动过滤：

• PHP代码层面处理（针对php-pdftk）：
  拿到getDataFields()的返回数组后，遍历每个字段，判断是否是单选按钮组，然后过滤掉自动生成的"Off"选项。示例代码如下：

  $fields = $pdftk->getDataFields();
  foreach ($fields as &$field) {
      // 判断当前字段是否为单选按钮组
      if ($field['FieldType'] === 'Btn' && str_contains($field['FieldFlags'], 'Radio')) {
          // 过滤掉自动生成的Off选项（前提是原表单无Off选项）
          $field['FieldStateOption'] = array_filter($field['FieldStateOption'], function($option) {
              return $option !== 'Off';
          });
          // 重置数组索引
          $field['FieldStateOption'] = array_values($field['FieldStateOption']);
      }
  }
  unset($field);
  

• 直接处理pdftk命令输出：
  如果是直接调用pdftk命令，可以用shell工具精准过滤多余的FieldStateOption: Off行，避免误删原表单自带的Off选项。比如用awk实现：

  pdftk your_form.pdf dump_data_fields | awk '!/FieldStateOption: Off/ || prev ~ /FieldStateOption: (On)/' prev=$0
  

  这个命令的逻辑是：仅保留和"On"选项配对的Off行（即原表单是On/Off组的情况），其他的Off行全部过滤掉。

内容的提问来源于stack exchange，提问作者Ben Holness