Skip to content

README.zh-CN.md

Latest commit

 

History

History
228 lines (163 loc) · 10 KB

README.zh-CN.md

File metadata and controls

228 lines (163 loc) · 10 KB
App icon

VCF 生成器 Lite 使用 Tkinter

仓库： Gitee 主仓库 GitHub 副仓库

平台： Windows 8.1+ (exe) Python 3.12+ (pyzw)

语言： 简体中文 | English | 期待您的翻译！

VCF 生成器 Lite 可以将联系人列表转换为单个 vCard 文件，可批量导入到手机通讯录，或者用作其它用途。

许可证 贡献者公约

GitHub - 测试 GitHub - Release GitHub - Stars Gitee - Stars

功能

  • 智能解析：按 姓名 电话 备注 格式批量识别联系人（备注可选），自动处理制表符和空格。
  • 批量生成：将所有联系人合并生成单个 .vcf 文件。
  • 号码校验：自动跳过无效号码，并快速定位错误行。
  • 辅助编辑：文本区显示行号，支持一键删除引号。

软件截图

主窗口

错误行展示窗口

获取应用

下载软件包

您可以通过以下渠道下载软件包：

请根据您的使用平台选择相应的软件包：

平台 软件包类型 需要安装 文件
Windows 安装程序 是 VCFGeneratorLite-<应用版本>-win-amd64-setup.exe
Windows 便携包 否 VCFGeneratorLite-<应用版本>-win-amd64-portable.zip
跨平台 Python Wheel 可选 vcf_generator_lite-<应用版本>-py3-none-any.whl
跨平台 Python ZIP 应用 否 VCFGeneratorLite-<应用版本>-py3.pyzw

使用 Python Wheel

Python Wheel (.whl) 文件适合熟悉命令行的用户。推荐使用隔离环境运行，避免依赖冲突。

方式一：临时运行（最简单，无需安装）

使用 uvx，命令执行后会自动创建临时环境并运行程序。

uvx <whl文件路径>

Note

uvx 是 uv tool run 的简写形式，由 uv 工具提供。

方式二：安装后使用（适合长期使用）

使用以下工具之一安装，会自动创建独立虚拟环境，不影响系统 Python。

# 使用 pipx
pipx install <whl文件路径>

# 或使用 uv
uv tool install <whl文件路径>

安装完成后，以后只需在终端中输入以下命令即可运行：

vcf-generator-lite

Tip

如果尚未安装 uv / pipx，请先运行 pip install uv 或 pip install pipx。

使用方法

  1. 把名字和电话以每行 姓名 电话 备注 的格式复制到主界面的文本框中，其中备注可忽略。例如： 
    张三	13345367789	网络名人
李四	13445467890
王五	13554678907
赵六	13645436748
  2. 点击 开始生成，选择一个路径保存文件。
  3. 您可以将生成后的 vCard 文件用在您需要的地方，详情请参阅下文 使用 vCard 文件。

Note

  • 您可以同时使用制表符和空格分割姓名与电话号码。
  • 程序会自动去除文本框内多余的空格。

例如 东坡居士 苏轼 13333333333 眉州眉山人 将会被识别为

  • 姓名：东坡居士 苏轼
  • 电话：13333333333
  • 备注：眉州眉山人

使用 vCard 文件

导入到手机通讯录
  1. 传输 vCard 文件到手机内。
  2. 打开 vCard 文件，选择 通讯录，然后根据提示操作。
  3. 等待导入完成。
导入到 QQ 邮箱
  1. 打开新版 QQ 邮箱网站。
  2. 在侧边栏中选择 应用 > 联系人，然后选择 管理 > 导入联系人。
  3. 在弹出的对话框中，点击 选择文件 选择框，选择您的 vCard 文件。
  4. 点击 开始导入。
导入到飞书
  1. 打开飞书客户端。
  2. 在侧边栏中选择 通讯录 > 邮箱通讯录，然后选择 添加 > 导入联系人 按钮。
  3. 在弹出的对话框中，选择或拖入您的 vCard 文件。
  4. 点击 导入。

兼容性

系统要求

软件包类型 系统环境
Windows 安装程序、便携包 Windows 8.1 或更高版本
Python ZIP 应用 Python 3.12 或更高版本、Tkinter

如果您需要在 Windows 8 及以下版本中使用本应用，请参阅 在旧版本 Windows 中运行。

如果您需要在 Windows 中直接双击启动 Python ZIP 应用，请安装 Python 安装管理器（推荐）或者 Python 启动器。

vCard 兼容性

  • 支持 vCard 版本：2.1
  • 支持字段：姓名、电话号码、备注
  • 已知问题：
    • Windows 联系人：在非 UTF-8 环境下可能出现乱码。

其他兼容性

系统环境 问题 说明 规避方法
Windows 10 或更高版本 不支持深色模式 Tkinter 没有内置深色主题。 使用高对比度主题，或者使用第三方工具（如 Rectify11）修改系统主题。
Windows 10 或更高版本 DPI 变化时界面变模糊 应用不支持启动后调节 DPI。 请尽量保持 DPI 相同以避免模糊。
Python 安装管理器 26.0 或更低版本 双击启动后会显示命令行窗口 Python 安装管理器 26.0 或更低版本不支持自动升级为窗口化的 Python 解释器。(python/cpython#261) 将 Python 安装管理器 升级到 26.1 或更高版本，或使用 Python 启动器。

致谢

  • AI：本项目部分内容由 AI 生成。
    • DeepSeek：指导编码、生成代码。
    • 元宝：指导编码、生成代码。
    • 通义灵码：补全代码、指导编码。
    • WorkBuddy：审查代码。
    • Trae：生成代码。
  • 开源代码：本项目使用了一些开源代码，详情请见 开源声明。

许可证

本项目以 Apache 2.0 许可证授权，详情请参阅 LICENSE 文件。

Copyright 2023-2026 Jesse205

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

更多文档