不用“利息÷本金÷年限”：如何用现金流 IRR 计算贷款真实年化率
不少贷款成本计算，最后会落到这个公式：
年化率 = 总利息 ÷ 贷款本金 ÷ 贷款年限
这个算法看起来合理，算出来也像一个百分比，但它忽略了还款时间。对于按月还本的贷款，借款人占用的本金会持续下降；如果还有手续费、服务费或期末尾款，误差会更明显。
更合适的做法，是把放款和每次还款都记成现金流，再求这组现金流的内部收益率，也就是 IRR。
为什么简单除法会失真
假设借款 10 万元，期限 12 个月，名义年利率 12%，采用等额本息还款。
月利率为 1%，月供可以用下面的公式计算：
[
M=P\times\frac{r(1+r)^n}{(1+r)^n-1}
]
其中：
- (P) 是贷款本金；
- (r) 是月利率；
- (n) 是还款期数；
- (M) 是每月还款额。
代入数据后，月供约为 8884.88 元，12 个月共还 106618.55 元，总利息为 6618.55 元。
如果直接计算：
6618.55 ÷ 100000 ÷ 1 = 6.62%
结果只有 6.62%。问题很直观：借款人并没有完整占用 10 万元一整年。每还一期，本金余额都会下降。
名义年利率 12% 对应的月利率是 1%。如果按月复利换算，有效年化率为：
[
(1+1\%)^{12}-1=12.68\%
]
6.62% 和 12.68% 相差接近一倍。这不是小数位造成的误差，而是计算模型错了。
把贷款写成现金流
站在借款人的角度，收到的钱记为正数，支付的钱记为负数。
没有额外费用时，现金流可以写成：
第 0 期：+100000.00
第 1 期：-8884.88
第 2 期：-8884.88
……
第 12 期：-8884.88
现在再加一笔 2000 元的放款手续费。合同本金仍然是 10 万元，但借款人实际拿到的只有 98000 元：
第 0 期：+98000.00
第 1 期：-8884.88
……
第 12 期：-8884.88
IRR 要寻找一个月利率 (r)，使这组现金流的净现值等于零：
[
\sum_{t=0}^{n}\frac{CF_t}{(1+r)^t}=0
]
这里的 (CF_t) 是第 (t) 期现金流。求出来的 (r) 是月度 IRR，再按复利换算成年化率：
[
年化率=(1+r)^{12}-1
]
用 JavaScript 求 IRR
JavaScript 标准库没有直接提供 IRR 函数，不过可以用二分法求解。对于“期初收到一笔钱，之后持续还款”的普通贷款现金流，二分法已经够用。
function npv(rate, cashFlows) {
return cashFlows.reduce((sum, cashFlow, period) => {
return sum + cashFlow / Math.pow(1 + rate, period);
}, 0);
}
function irr(cashFlows, options = {
}) {
const {
minRate = -0.9999,
maxRate = 10,
tolerance = 1e-10,
maxIterations = 200
} = options;
let left = minRate;
let right = maxRate;
let leftValue = npv(left, cashFlows);
let rightValue = npv(right, cashFlows);
if (leftValue * rightValue > 0) {
throw new Error("给定区间内没有找到可求解的 IRR");
}
for (let i = 0; i < maxIterations; i++) {
const middle = (left + right) / 2;
const middleValue = npv(middle, cashFlows);
if (
Math.abs(middleValue) < tolerance ||
Math.abs(right - left) < tolerance
) {
return middle;
}
if (leftValue * middleValue <= 0) {
right = middle;
rightValue = middleValue;
} else {
left = middle;
leftValue = middleValue;
}
}
return (left + right) / 2;
}
然后构造贷款现金流：
const principal = 100000;
const upfrontFee = 2000;
const months = 12;
const quotedMonthlyRate = 0.01;
const monthlyPayment =
principal *
quotedMonthlyRate /
(1 - Math.pow(1 + quotedMonthlyRate, -months));
const cashFlows = [
principal - upfrontFee,
...Array(months).fill(-monthlyPayment)
];
const monthlyIrr = irr(cashFlows);
const effectiveAnnualRate = Math.pow(1 + monthlyIrr, 12) - 1;
console.log("月供：", monthlyPayment.toFixed(2));
console.log("月度 IRR：", (monthlyIrr * 100).toFixed(4) + "%");
console.log("真实年化率：", (effectiveAnnualRate * 100).toFixed(2) + "%");
运行结果约为：
月供：8884.88
月度 IRR：1.3212%
真实年化率：17.06%
合同上的名义年利率是 12%，加入 2000 元前置手续费后，按实际现金流计算的有效年化率约为 17.06%。
如果想修改本金、期数、月供和费用后快速复算，也可以使用这个真实年化率计算器核对结果。工具计算的仍然是现金流 IRR，不是把总费用简单除以合同本金。
手续费应该放在哪一期
费用发生的时间不能随便处理。
放款时直接扣除的费用，应从第 0 期到账金额中扣掉：
const initialCashFlow = principal - upfrontFee;
每月收取的账户管理费，应加入对应月份的支出：
const monthlyCashFlow = -(monthlyPayment + monthlyManagementFee);
最后一期支付的尾款，需要加到最后一期：
cashFlows[cashFlows.length - 1] -= balloonPayment;
同样是 2000 元费用，放款当天扣除和第 12 个月支付，对 IRR 的影响并不相同。越早发生的支出，通常对实际资金成本影响越大。
实现时容易踩的几个坑
1. 月度 IRR 不能直接乘以 12
const nominalAnnualRate = monthlyIrr * 12;
这种写法得到的是名义年化率。需要有效年化率时，应使用：
const effectiveAnnualRate = Math.pow(1 + monthlyIrr, 12) - 1;
在前面的例子中，月度 IRR 为 1.3212%。直接乘以 12 得到 15.85%，按复利计算则是 17.06%。
2. 不要假设净现值会精确等于零
浮点数计算存在舍入误差，所以代码应判断：
Math.abs(npvValue) < tolerance
不要写成：
npvValue === 0
如果业务系统按分存储金额，最好先统一金额精度，再执行 IRR 计算。月供是否先四舍五入到分，也可能让最后结果出现几个基点的差异。
3. IRR 不一定只有一个解
普通贷款一般只有一次现金流符号变化：期初为正，之后为负，这类现金流通常只有一个有效解。
如果中途出现退款、追加放款或多次正负切换，可能产生多个 IRR，也可能找不到可用解。这时不能只调整循环次数，而要检查现金流结构，必要时直接比较不同贴现率下的净现值。
4. 日期不规则时要用 XIRR
上面的算法默认每期时间间隔相同，适用于按月还款。
如果放款日、还款日并不等距，应根据实际天数折现：
[
NPV(r)=\sum_{i=0}^{n}\frac{CF_i}{(1+r)^{(d_i-d_0)/365}}
]
这类计算通常称为 XIRR。把相隔 20 天和相隔 40 天的两笔还款都当成“一个月”，结果不会准确。
IRR 算出的是什么
现金流 IRR 回答的是：按照实际到账金额和约定还款安排，这笔资金对应多高的周期收益率。
它适合比较包含手续费、服务费、尾款等项目的贷款方案，但不必然等同于监管文件或合同中定义的 APR。不同口径可能对税费、可选服务、逾期费用和计息天数有不同规定。做产品时，应把采用的费用范围、还款日期和年化方式写清楚。
“利息÷本金÷年限”只能粗略描述总费用。只要贷款在分期归还本金，或者费用发生时间不同，就应该回到现金流。每一笔钱在什么时候收到、什么时候付出，才是年化资金成本的计算基础。
