前段时间帮财务部门做了个报销单PDF，他们要求填写金额后自动计算税额、总计、大写金额等等。一开始想着让用户填完后端计算，后来发现PDF本身就支持字段计算——用的是Adobe在PDF 1.3时代就加入的JavaScript引擎。这玩意儿虽然老，但能力不容小觑。

🧮 基础案例：自动求和

最简单的场景：有三个输入框item1、item2、item3，一个总计框total。在total字段的Calculate事件里写：

// Calculate事件脚本
var v1 = +this.getField("item1").value || 0;
var v2 = +this.getField("item2").value || 0;
var v3 = +this.getField("item3").value || 0;

event.value = v1 + v2 + v3;

⚡ 事件触发顺序的坑

PDF表单的计算顺序是按字段的Tab Order（标签顺序）来的。如果顺序不对，会导致计算错误。举个例子：

在Adobe Acrobat里可以通过"表单→编辑字段→更多→设置标签顺序"来调整。用代码生成PDF时要特别注意这个顺序。

🎯 进阶：条件计算和折扣逻辑

实际业务场景往往更复杂。比如报价单：购买数量超过100件打9折，超过500件打8折。这需要用到条件判断：

// 在"最终价格"字段的Calculate事件
var price = +this.getField("unit_price").value || 0;
var qty = +this.getField("quantity").value || 0;
var subtotal = price * qty;
var discount = 1.0;

// 根据数量确定折扣
if (qty >= 500) {
    discount = 0.8;
    this.getField("discount_label").value = "8折优惠";
} else if (qty >= 100) {
    discount = 0.9;
    this.getField("discount_label").value = "9折优惠";
} else {
    this.getField("discount_label").value = "原价";
}

// 应用折扣
event.value = (subtotal * discount).toFixed(2);

注意这里还顺带更新了discount_label字段，给用户显示当前折扣信息。这就是PDF表单的强大之处——一个计算脚本可以影响多个字段。

🔢 数字转大写金额

财务单据常见需求：把阿拉伯数字转成中文大写（12345.67 → 壹万贰仟叁佰肆拾伍元陆角柒分）。这个逻辑稍微复杂，但JS可以搞定：

// 在"大写金额"字段的Calculate事件
function convertToChinese(num) {
    var digits = ['零', '壹', '贰', '叁', '肆', '伍', '陆', '柒', '捌', '玖'];
    var units = ['', '拾', '佰', '仟'];
    var bigUnits = ['', '万', '亿'];
    
    var parts = num.toFixed(2).split('.');
    var intPart = parts[0];
    var decPart = parts[1];
    
    // 转换整数部分（这里简化了，完整实现需要处理零的各种情况）
    var result = '';
    var len = intPart.length;
    for (var i = 0; i < len; i++) {
        var digit = intPart[i];
        var pos = len - i - 1;
        if (digit != '0') {
            result += digits[digit] + units[pos % 4];
        }
        if (pos % 4 == 0 && pos > 0) {
            result += bigUnits[pos / 4];
        }
    }
    
    result += '元';
    
    // 转换小数部分
    if (decPart[0] != '0') result += digits[decPart[0]] + '角';
    if (decPart[1] != '0') result += digits[decPart[1]] + '分';
    else result += '整';
    
    return result;
}

var amount = +this.getField("total_amount").value || 0;
event.value = convertToChinese(amount);

📅 日期自动填充和校验

另一个常见需求：自动填充当前日期，或者校验日期范围。PDF的JavaScript有内置的Date对象：

// 在"填表日期"字段的默认值脚本（Document JavaScript）
var today = new Date();
var year = today.getFullYear();
var month = ('0' + (today.getMonth() + 1)).slice(-2);
var day = ('0' + today.getDate()).slice(-2);

this.getField("fill_date").value = year + '-' + month + '-' + day;

// 在"截止日期"字段的Validate事件（校验逻辑）
var deadline = new Date(event.value);
var today = new Date();

if (deadline < today) {
    app.alert("截止日期不能早于今天！");
    event.rc = false;  // 拒绝这个值
}

🔗 字段联动：下拉框级联

经典的省市区三级联动，PDF也能实现。核心是监听第一个下拉框的变化，动态更新第二个：

// 在"省份"字段的OnChange事件（或叫Format事件）
var cityData = {
    '广东省': ['广州市', '深圳市', '珠海市'],
    '浙江省': ['杭州市', '宁波市', '温州市'],
    '江苏省': ['南京市', '苏州市', '无锡市']
};

var province = event.value;
var cityField = this.getField("city");

// 清空并重新填充城市列表
cityField.clearItems();
if (cityData[province]) {
    for (var i = 0; i < cityData[province].length; i++) {
        cityField.insertItemAt(cityData[province][i], i);
    }
    cityField.value = cityData[province][0];  // 默认选第一个
}

🛠️ 用代码生成带计算脚本的PDF

纯手工在Adobe Acrobat里配置脚本太慢，生产环境都是代码生成。用PyPDF2可以这样做：

from PyPDF2 import PdfWriter, PdfReader
from PyPDF2.generic import DictionaryObject, TextStringObject

def add_calculated_field(pdf_path, output_path):
    reader = PdfReader(pdf_path)
    writer = PdfWriter()
    
    # 复制所有页面
    for page in reader.pages:
        writer.add_page(page)
    
    # 创建计算字段
    field = DictionaryObject()
    field.update({
        '/FT': '/Tx',  # Text字段
        '/T': TextStringObject('total'),  # 字段名
        '/V': TextStringObject('0'),  # 默认值
        '/Rect': [100, 700, 200, 720],  # 位置和大小
        '/AA': {  # Additional Actions
            '/C': {  # Calculate事件
                '/S': '/JavaScript',
                '/JS': TextStringObject(
                    '''
                    var v1 = +this.getField("item1").value || 0;
                    var v2 = +this.getField("item2").value || 0;
                    event.value = v1 + v2;
                    '''
                )
            }
        }
    })
    
    # 添加到表单字段
    if '/AcroForm' not in writer._root_object:
        writer._root_object['/AcroForm'] = DictionaryObject()
    
    if '/Fields' not in writer._root_object['/AcroForm']:
        writer._root_object['/AcroForm']['/Fields'] = []
    
    writer._root_object['/AcroForm']['/Fields'].append(field)
    
    with open(output_path, 'wb') as f:
        writer.write(f)

add_calculated_field('template.pdf', 'output.pdf')

💼 实际应用案例

🔍 调试技巧