终极指南：如何使用Persian-Tools快速处理波斯语数据

Persian-Tools是一个功能强大的TypeScript工具集，专门为处理波斯语（Farsi）文本、数字、验证和本地化工具而设计。这个全面的库无关框架，可在Node.js、Bun和浏览器中运行，为开发者提供了27+种实用工具，让波斯语数据处理变得前所未有的简单。

🎯 为什么选择Persian-Tools？

在开发波斯语应用程序时，经常会遇到各种挑战：数字格式转换、文本验证、地理位置信息处理等。Persian-Tools将这些常见需求打包成一个统一的解决方案，让你的开发工作更加高效。

🔥 核心功能亮点

数字与文本处理

• 数字转换：波斯语单词与数字之间的相互转换，支持模糊匹配
• 数字格式转换：波斯语、阿拉伯语、英语数字之间的自动转换
• 逗号格式化：添加或移除千位分隔符
• 序数词处理：与序数形式的相互转换

验证与身份认证

• 国家身份证号：验证和生成伊朗国家代码（کد ملی）
• 法人身份证号：验证伊朗法人实体ID（شناسه حقوقی）
• 电话号码：验证和提取运营商信息
• 银行卡：验证和识别银行名称
• 提取卡号：高级卡号提取，支持模糊匹配和性能优化

地理与位置服务

• 位置查找：根据国家ID查找城市/省份
• 省会城市：获取各省省会信息
• 坐标处理：根据GPS坐标查找省份
• 车牌解析：解析伊朗车牌信息

🚀 快速入门指南

安装步骤

# npm
npm install @persian-tools/persian-tools

# yarn  
yarn add @persian-tools/persian-tools

# pnpm
pnpm add @persian-tools/persian-tools

# bun（推荐）
bun add @persian-tools/persian-tools

基础使用示例

import { numberToWords, digitsEnToFa, verifyIranianNationalId } from '@persian-tools/persian-tools';

// 数字转波斯语单词
numberToWords(1234); // "یک هزار و دویست و سی و چهار"

// 英语数字转波斯语数字
digitsEnToFa("123"); // "۱۲۳"

// 验证伊朗国家ID
verifyIranianNationalId("0499370899"); // true

📊 实际应用场景

金融领域

Persian-Tools在银行和金融应用中表现出色，支持银行卡验证、IBAN账户验证等功能。模块路径：src/modules/banksRegex/

地理信息系统

对于需要处理伊朗地理位置信息的应用，Persian-Tools提供了完整的解决方案。模块路径：src/modules/findCapitalByProvince/

文本处理

无论是网站内容管理还是文档处理，Persian-Tools都能提供强大的波斯语文本分析功能。

💡 最佳实践建议

1. 类型安全优先：充分利用TypeScript的类型系统
2. 性能优化：对于大型文档使用专门的优化选项
3. 错误处理：合理使用验证功能确保数据质量

🛠️ 开发与贡献

项目采用现代化的开发栈：

• TypeScript：完整的类型安全，严格模式
• 构建工具：Unbuild（双ESM/CJS输出）
• 测试框架：Vitest，提供全面的测试覆盖
• 代码质量：ESLint + Prettier + Husky钩子

🌟 谁在使用Persian-Tools？

许多知名伊朗企业和项目都在使用Persian-Tools，包括银行应用、房地产平台和电商网站等。这些成功案例证明了工具集的实用性和可靠性。

通过这个终极指南，你现在应该对Persian-Tools有了全面的了解。无论你是初学者还是有经验的开发者，这个工具集都能显著提升你处理波斯语数据的效率和准确性。