Hướng dẫn sử dụng
Mở tệp tsudev-contact_..._x64-setup.exe là dùng được ngay, không cần cài đặt. Cửa sổ có ba bước xếp từ trái sang phải.
Bước 1: chọn tệp CSV
Kéo tệp vào ô Kéo thả tệp CSV vào đây, hoặc bấm Chọn tệp... (Ctrl+O). Ứng dụng tự nhận bảng mã (UTF-8, UTF-16, Windows-1258 của Excel tiếng Việt) và dấu phân cách (phẩy, chấm phẩy, tab, gạch đứng), rồi hiện số dòng đọc được. Chưa có tệp? Xem Chuẩn bị tệp CSV.
Bước 2: ghép cột
Mỗi trường của danh bạ có một ô chọn cột CSV. Ứng dụng tự đoán theo tên cột tiếng Việt, tiếng Anh và tên cột của Google Contacts; bên dưới mỗi ô là giá trị mẫu lấy từ tệp để bạn kiểm tra nhanh. Hai trường bắt buộc là Họ tên và Số điện thoại; trường nào không có trong tệp thì để (Không dùng).
- Tự thêm số 0 đầu bị Excel làm mất (mặc định bật): số 9 chữ số bắt đầu bằng 3, 5, 7, 8, 9 được thêm số 0, ví dụ
912345678thành0912345678. Dòng đó được đánh dấu Cảnh báo để bạn biết. - Không xuất liên hệ trùng số điện thoại: bật khi muốn bỏ hẳn các dòng trùng số với một dòng phía trên. Tắt thì vẫn xuất nhưng có Cảnh báo.
Mỗi lần đổi ghép cột hay tùy chọn, dữ liệu được kiểm tra lại tự động.
Bước 3: xem trước và xuất
Bảng bên phải hiện từng liên hệ kèm số dòng trong tệp gốc. Bấm Tất cả, Hợp lệ, Cảnh báo, Lỗi để lọc; ô tìm kiếm (Ctrl+F) tìm theo tên, số, email, gõ không dấu vẫn ra. Góc dưới bên trái chọn số dòng mỗi trang.
- Xuất vCard (Ctrl+E): ghi tệp
.vcfgồm mọi liên hệ không bị Lỗi. Hộp thoại hỏi trước khi ghi đè tệp đã có. - Xuất báo cáo lỗi: ghi các dòng Cảnh báo, Lỗi ra tệp CSV mở được bằng Excel, có cột mô tả vấn đề. Tệp này chứa thông tin cá nhân: lưu ở nơi an toàn, sửa xong thì xóa.
Hợp lệ, Cảnh báo, Lỗi
| Trạng thái | Nghĩa | Ví dụ |
|---|---|---|
| Hợp lệ | Xuất bình thường | Có tên và ít nhất một số điện thoại đúng |
| Cảnh báo | Vẫn xuất, nhưng một phần bị sửa hoặc bỏ | Email sai bị bỏ; ngày sinh không có thật; đã thêm số 0 đầu; trùng số với dòng khác; ô quá dài bị cắt |
| Lỗi | Không xuất | Thiếu tên; ô số điện thoại trống hoặc toàn chữ; số quá ngắn, quá dài |
Một ô có nhiều số (cách nhau bằng /, ;, ,, xuống dòng hoặc chữ "hoặc") được tách thành nhiều số trong cùng liên hệ; số đầu tiên là số chính.
Nạp vào điện thoại
- Android: chép tệp
.vcfvào máy, mở ứng dụng Danh bạ, chọn Nhập từ bộ nhớ (tên mục khác nhau tùy hãng), chọn tệp. - Google Contacts (đồng bộ mọi máy): vào
contacts.google.com, Nhập, chọn tệp.vcf. - iPhone: gửi tệp vào máy (AirDrop, Thư, Tệp), chạm vào tệp, chọn Thêm tất cả liên hệ; hoặc nhập qua
icloud.com/contacts.
Nên thử nạp vài liên hệ trước bằng cách lọc và xuất một tệp nhỏ, nhất là khi điện thoại đã có sẵn danh bạ.
Giao diện và ngôn ngữ
Nút Giao diện ở góc trên chọn Theo hệ thống, Sáng, Ấm (dịu mắt khi làm lâu) hoặc Tối. Nút Ngôn ngữ đổi giữa Tiếng Việt (mặc định) và English. Lựa chọn được ghi nhớ cho lần mở sau; tệp cấu hình chỉ chứa các lựa chọn hiển thị, không chứa danh bạ.
Phím tắt
- Ctrl+O: chọn tệp CSV
- Ctrl+F: tìm trong bảng xem trước
- Ctrl+E: xuất vCard
- F1: Giới thiệu
Xử lý sự cố
- "Tệp không phải văn bản CSV": tệp là bảng tính Excel (
.xlsx). Mở bằng Excel, chọn Lưu dưới dạng, kiểu CSV UTF-8 (phân cách bằng dấu phẩy). - Chữ tiếng Việt bị lỗi: tệp dùng bảng mã cũ (TCVN3, VNI) mà ứng dụng không đọc được. Chuyển sang Unicode bằng Unikey (Công cụ chuyển mã) rồi lưu lại dạng CSV UTF-8.
- Nhiều dòng "Ô số điện thoại không chứa chữ số nào": thường do lệch cột trong tệp gốc (chức vụ, ghi chú nằm nhầm cột số). Xuất báo cáo lỗi để sửa.
- Windows cảnh báo SmartScreen ở lần chạy đầu: xem Kiểm tra tệp, rồi chọn Thông tin thêm, Vẫn chạy.
Gặp lỗi khác? Mở issue trên GitHub. Đừng đính kèm danh bạ thật; hãy tạo tệp mẫu vài dòng với tên, số giả.