vCard 檔案（.vcf）是一種純文字聯絡人記錄，定義於 RFC 6350，任何現代的通訊錄或聯絡人應用程式都能透過單一的檔案選擇視窗匯入。若要在線上建立 VCF 檔案，您只需填寫一份簡短的表單，至少輸入全名，並可選擇性地新增組織、職稱、電子郵件、電話、網站和備註等詳細資訊，預覽產生的 vCard 4.0 文字內容，然後將檔案下載為 .vcf，這樣您的聯絡人應用程式就能讀取它。vCard Generator 會在目前的瀏覽器分頁中執行整個工作流程，因此您輸入的資料絕不會傳送到遠端伺服器。由於該檔案是包裹在 BEGIN:VCARD 與 END:VCARD 標記之間的純文字，您可以在任何文字編輯器中開啟它，以便日後檢查或修正。手工製作有效 vCard 最困難的部分不是輸入內容——而是匯入工具會默默強制執行的跳脫規則和行長度規則。讓一個專注的產生器代為套用這些規則，是取得可攜式聯絡人檔案最簡單的方法。
vCard .vcf 檔案內含哪些內容
.vcf 檔案是一份包裹在兩個標記之間的屬性行清單。檔案以 BEGIN:VCARD 這一行開頭，並以 END:VCARD 結束。在這些標記之間是屬性行，每一行各自獨立，格式為 NAME:value 或 NAME;parameters:value。VERSION 屬性用於識別該檔案遵循哪一個 vCard 規格；vCard Generator 在每次輸出時都會寫入 VERSION:4.0，以符合 RFC 6350 中所描述的格式，以及 IANA vCard Elements Registry 中的標準屬性清單。
當您只想要一筆聯絡人資料時，為什麼格式還是很重要？因為匯入端並非可有可無。手機和桌面上的大多數通訊錄和聯絡人應用程式都會自行剖析 .vcf 檔案，而每個匯入工具對於格式錯誤的容忍度各不相同。如果檔案違反了結構規則，匯入工具可能會悄悄略過某個屬性、顯示錯誤的姓名，或直接拒絕該檔案。一個遵循 RFC 6350 核心規則的產生器所產生的檔案，可以讓所有這些應用程式都讀取，無需特殊的處理方式——這也是該標準存在的實際原因。
如何在瀏覽器中建立您的 .vcf 檔案
建立流程分為三個步驟。唯一必填的欄位是全名，其他所有欄位都是選填的。空白選填欄位不會寫入輸出內容，而是直接省略，這樣可以讓檔案更精簡，並避免匯入工具嘗試解析意義不明的條目。
- 輸入必填的全名，然後視需要新增組織、職稱、電子郵件、電話、網站或備註。
- 選擇 Create vCard，並在預覽中仔細檢查 vCard 4.0 文字內容的拼字與格式。
- 下載 .vcf 檔案，並在您的目標聯絡人應用程式中測試匯入，再進行分享。
在下載之前，請像校對電子郵件那樣仔細閱讀預覽內容。確認姓名的拼字、電話號碼的國碼、電子郵件的網域，以及網站的路徑是否正確。預覽內容反映 .vcf 檔案將包含的確切位元組，包括任何跳脫序列和折行，因此在這個步驟仔細檢查，可以避免日後在聯絡人應用程式中不必要的來回修改。如果您發現問題，請編輯表單中的值，重新產生，再檢查一次預覽，而不是手動編輯檔案。
產生器輸出的屬性
產生器刻意保持精簡的屬性集。下表列出它可以輸出的每個屬性、該值在表單中的來源，以及根據 RFC 6350 該屬性所儲存的內容。
| vCard 屬性 | 表單欄位 | 儲存內容 |
|---|---|---|
| VERSION | 永遠輸出 | 格式版本，寫為 "4.0" |
| FN | 全名 | 在聯絡人清單中顯示的格式化姓名 |
| ORG | 組織 | 公司或機構名稱 |
| TITLE | 職稱 | 職位或角色 |
| 電子郵件 | 電子郵件地址 | |
| TEL | 電話 | 電話號碼，可包含任何格式或國碼 |
| URL | 網站 | 公開的 HTTP 或 HTTPS URL |
| NOTE | 備註 | 自由格式文字，可包含多行內容 |
必填的 FN 行永遠會被寫入，因為缺少格式化姓名的聯絡人檔案並不是一個實用的可攜式記錄。選填欄位只有在您提供值時才會被寫入。產生器刻意不包含照片、社交檔案連結、地址，或特定廠商的同步擴充功能，因為輸出保守的純文字屬性集可以讓不同匯入工具之間的結果更可預測。如果您想了解能順利通過多種匯入工具的記錄建立全貌，建立可在任何地方乾淨匯入的 vCard 指南 提供了更全面的說明。
為什麼跳脫和折行很重要
RFC 6350 規定了兩條容易被忽略的文字規則。第一，值中的逗號、分號、反斜線和換行必須使用反斜線進行跳脫，讓匯入工具將它們視為內容而非結構標點。像 "Doe, Jane" 這類姓名中的逗號，在結構化姓名屬性中必須以跳脫形式出現；而組織名稱中像 "Smith; Jones LLC" 這樣的分號，也必須跳脫，以免被剖析為多個組織元件。如果沒有跳脫，匯入工具可能會將標點解讀為結構而非聯絡人值的一部分，導致該欄位顯示錯誤。
第二，每個實體內容行的長度上限為 75 個位元組（以 UTF-8 計算，而非 JavaScript 字元數）。較長的行必須透過插入 CRLF 並在下一個實體行的開頭加上一個空格來進行折行。折行必須遵循完整的 Unicode 碼點，以避免表情符號或多位元組字元在其 UTF-8 編碼中間被切斷。產生器會在最多 75 個位元組處折行，並在每個接續行的開頭加上一個空格。下載的檔案全程使用 CRLF 行尾結束符號，並以最終的 CRLF 結束，符合 RFC 6350 的規定。
值內部的文字換行是使用 vCard 換行跳脫序列在屬性本身內部進行編碼，而不是允許它插入額外的屬性。對於包含多段文字的備註來說，這個細節很重要：未跳脫的換行符號可能會被誤認為新屬性而導致檔案損壞，這就是為什麼產生器會代為處理編碼。
本機瀏覽器處理與聯絡人隱私
所有處理作業都在目前的瀏覽器分頁中完成。表單值、預覽內容和下載的檔案都是在本地組裝。下載連結指向由預覽文字所建立的暫存瀏覽器 Blob。資料不會上傳到伺服器、不會儲存在帳號中，也不會傳送到遠端轉換服務。關閉或重新載入頁面將同時清除輸入的資料和產生的下載連結。
當聯絡人資料屬於私密資訊時，這種本地化設計具有實際價值。不需要建立帳號、不需要確認電子郵件，也沒有任何服務會保留聯絡人記錄的副本。如果您需要為單一聯絡人快速建立檔案，而不希望透過第三方表單傳送資料，那麼這種瀏覽器端工作流程正是此工具的相關特性。
其他輸入控制項也支援相同的目標。網站項目必須是公開的 HTTP 或 HTTPS URL，且會拒絕內嵌的使用者名稱和密碼。其他聯絡人欄位會拒絕不支援的控制字元，並套用實際的長度限制。產生器並不會聲明電子郵件地址或電話號碼屬於真實人物；它只是將您提供的值進行序列化，因此聯絡人記錄的正確性由您自行負責。
分享前先測試匯入
下載 .vcf 檔案後，最後的相容性檢查就是實際匯入。各應用程式的匯入行為和支援的選填屬性可能有所不同，因此閱讀預覽雖然必要但並不充分。請將檔案匯入您打算使用的聯絡人應用程式，確認姓名顯示如預期、電話號碼保留國碼和格式、電子郵件網域正確，以及網站可正常開啟。如果任何欄位看起來有誤，請在表單中編輯來源值，重新產生並重新下載。
在純文字編輯器中檢查檔案也很有用，因為輸出內容就是純文字。當匯入行為異常，而您想查看問題出在來源值還是匯入工具時，這點特別有幫助。vCard 4.0 檔案並非數位身分、經驗證的簽章，也不能取代在分享他人聯絡人資訊前所應取得的同意，因此在傳送檔案前請考量收件人的隱私期望。