# vcard-tools

**Repository Path**: yf33/vcard-tools

## Basic Information

- **Project Name**: vcard-tools
- **Description**: 通讯录转vcard ， vcard 转cvs
手机通讯录导入导出工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: https://vcard.agcc.cc/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-25
- **Last Updated**: 2026-02-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# vCard Converter Tool

一个功能强大的web工具，用于在vCard格式和其他格式之间进行转换，方便用户管理和导入联系人信息。

## 功能特性

### 1. 文本转vCard
- 支持输入姓名和手机号码，转换为标准vCard格式
- 支持批量处理，每行一个联系人
- 自动验证电话号码格式
- 生成可直接导入手机的.vcf文件

### 2. vCard转CSV
- 支持上传vCard文件（.vcf格式）
- 自动解析vCard文件中的联系人信息
- 转换为标准CSV格式，可在电子表格应用中打开
- 支持处理大型vCard文件（已测试782个联系人）

### 3. 技术特点
- 纯客户端实现，无需服务器端处理
- 响应式设计，适配桌面和移动设备
- 支持多种电话号码格式
- 支持标准vCard 3.0格式
- 无外部依赖，使用纯HTML5、CSS3和JavaScript

## 使用方法

### 文本转vCard
1. 在"文本转vCard"部分的文本框中输入联系人信息
2. 格式：姓名 手机号码（用空格分隔），每行一个联系人
3. 点击"转换并下载"按钮
4. 下载生成的contacts.vcf文件
5. 将文件导入到手机通讯录

### vCard转CSV
1. 在"vCard 转 CSV"部分点击"选择文件"按钮
2. 选择要转换的vCard文件（.vcf格式）
3. 点击"转换为CSV"按钮
4. 下载生成的contacts.csv文件
5. 在Excel、Google Sheets等电子表格应用中打开

## 输入示例

### 文本转vCard输入示例
```
张三 13800138000
李四 13900139000
王五 13700137000
```

### 支持的电话号码格式
- 国内号码：13800138000
- 国际号码：+86 13800138000
- 带分隔符的号码：138-0013-8000

## 技术实现

- **前端框架**：纯HTML5、CSS3和JavaScript
- **文件处理**：使用FileReader API读取本地文件
- **文件下载**：使用Blob和URL.createObjectURL实现客户端下载
- **vCard解析**：支持解析vCard 3.0格式，处理折叠行和不同字段格式
- **响应式设计**：使用CSS媒体查询适配不同屏幕尺寸

## 浏览器兼容性

- Chrome 40+
- Firefox 35+
- Safari 10+
- Edge 14+

## 项目结构

```
vcard/
├── index.html          # 主页面
├── README.md           # 项目说明
├── test.vcf            # 测试vCard文件
└── test-parser.js      # 测试解析逻辑的脚本
```

## 注意事项

- 本工具仅在客户端运行，不会上传任何数据到服务器
- 支持的vCard字段：FN（显示名称）、N（结构化名称）、TEL（电话号码）
- 对于缺少姓名或电话的联系人，会在CSV中相应字段留空
- 大型vCard文件可能需要较长时间处理，请耐心等待

## 许可证

MIT License

## 贡献

欢迎提交Issue和Pull Request来改进这个工具！