直接用JavaScript计算个税易出错，因未遵循累计预扣法、忽略地域化社保公积金配置、缺乏专项附加扣除防重机制及动态政策更新。
为什么直接用 JavaScript 计算个税会出错？
浏览器里跑的 calculateTax() 函数，如果照搬 2023 年前的速算扣除数表或忽略专项附加扣除累计预扣逻辑，结果必然偏差。个税是累计预扣法，不是单月独立计算——January 和 December 的应纳税所得额基数不同，系统必须记住上月已缴税额、已扣专项附加额度、已缴社保公积金等状态。
- 累计收入、累计免税收入、累计减除费用（5000 × 月份数）、累计专项扣除（三险一金）、累计专项附加扣除、累计其他扣除，这六项缺一不可
- 国家税务总局《个人所得税扣缴申报管理办法（试行）》明确要求按月累计，而非“本月工资 ÷ 12”套用税率
- 社保和公积金比例因城市而异：
shanghai_pension_rate是 8%，guangzhou_pension_rate是 7%，硬编码会导致广州用户多缴税
怎么让计算器支持多地社保配置？
不能把北京、深圳、杭州的缴费比例写死在 JS 里，更不该让用户手动输百分比。正确做法是用对象映射城市与参数，并默认选中当前 IP 归属地（可用轻量级库 ipapi.co 或前端 fallback 到 localStorage 缓存）：
const cityConfig = {
'beijing': { pension: 0.08, medical: 0.02, unemployment: 0.002, housing: 0.12 },
'shenzhen': { pension: 0.08, medical: 0.02, unemployment: 0.003, housing: 0.12 },
'hangzhou': { pension: 0.08, medical: 0.02, unemployment: 0.005, housing: 0.12 }
};
- 用户切换城市时，只重算
socialSecurityDeduction和housingFundDeduction，不重刷整个页面 - 住房公积金上下限必须校验：
actualHousingFund=Math.min(Math.max(base * rate, lowerLimit), upperLimit) - 若用户勾选“按实际工资基数缴”，则跳过最低缴费基数限制逻辑，但需加警示：“低于最低基数可能影响医保报销额度”
专项附加扣除怎么防重复录入？
用户填了两个子女教育、三套房贷、四个赡养老人——这些在真实个税APP里是绑定身份证+人脸识别后由税务局统一校验的。前端能做的只有约束 UI 层：
-
每个
childrenEdu对象必须含studentId（18位身份证号后6位脱敏），相同studentId自动合并立即学习“前端免费学习笔记（深入）”；
houseLoan要求填写loanContractNo前8位，相同合同号禁止新增elderCare绑定被赡养人身份证号，同一身份证号只能关联一个纳税人（用Set存careeId）所有专项附加字段都加
required+pattern校验，比如子女教育起止时间必须是YYYY-MM格式不要自动填充“2023-01”，而是读取用户选择的“当前计算月份”，再推导累计可扣月份
为什么输出结果要区分“当月实发”和“年度累计”？
HR 发薪看的是当月数字，员工年底查账看的是全年汇总。两者逻辑不同：
monthlyTakeHome= 税前工资 − 社保公积金 − 个税 − 其他代扣（如工会费）annualAccumulatedTax= 上月annualAccumulatedTax+ 本月个税，这个值要和税务局个税APP里的“累计已缴税额”对得上个税计算函数必须接收
previousMonthsData参数，至少包含accumulatedIncome、accumulatedTax、accumulatedSpecialDeductions如果用户跳着算（比如先算12月再算1月），要清空缓存并提示：“累计数据已重置，请从1月开始顺序计算”
输出区域用两个
<dl>并排：左侧“本月明细”，右侧“年度累计”，避免用户误把月度个税当全年个税
个税规则每年微调，专项附加扣除标准、年终奖单独计税政策、全年一次性奖金过渡期截止日……这些都不是改一行代码就能生效的。最稳妥的做法是把税率表、扣除标准、政策有效期都做成 JSON 接口，由后台每日拉取更新，前端只负责渲染和校验。
