本 vCard 產生器可建立純文字 vCard 4.0 內容,並在每個實體行不超過 75 個 UTF-8 位元組的情況下折行長文字,且不會分割 Unicode 碼點。

在此工作流程中,「長文字」是指聯絡人記錄內較長或包含大量字元的值,而不是設計名片上的超大字樣。支援的輸出格式是可下載的 .vcf 檔案。vCard 產生器可讓你輸入聯絡資料、檢視實際產生的文字並下載,不必將這些資料傳送至遠端轉換服務。

當備註包含標點符號、多行內容、表情符號或非英文字元時,這項區別就很重要。檔案必須維持結構有效,而最終如何顯示匯入的資訊,仍由聯絡人應用程式決定。

vcard generator large text
長文字 vCard 產生器:安全的 vCard 4.0

vCard 4.0 內的長文字規則

vCard 是純文字,但純文字仍須遵循定義好的序列化規則。RFC 6350 中的核心內容行要求,規定了長邏輯值如何配置於實體行中。本產生器會將長值折行至多行、讓每個續行以一個空格開頭,並將每個實體行限制在不超過 75 個 UTF-8 位元組。

位元組的計算方式很重要,因為 UTF-8 字元可能占用一個以上的位元組。產生器會處理完整的 Unicode 碼點,因此不會從表情符號或其他多位元組字元的編碼中途將其分割。這可同時保護字元本身與 UTF-8 輸出的有效性。

長文字情況產生的處理方式可避免的問題
屬性產生長實體行在不超過 75 個 UTF-8 位元組的位置折行,並在每個續行開頭放置一個空格過長的內容行
值包含表情符號或多位元組文字處理完整的 Unicode 碼點字元在 UTF-8 編碼內被分割
值包含逗號、分號或反斜線套用 vCard 4.0 要求的文字逸出處理標點符號被解讀為 vCard 結構
值包含換行符號在屬性值內進行編碼注入額外的 vCard 屬性
檔案需要一致的行尾使用 CRLF 行尾,並在結尾加上 CRLF混用或不完整的記錄結尾

每筆產生的記錄都會以 BEGIN:VCARD 開頭、宣告 VERSION:4.0、以 FN 包含完整名稱、加入所提供的選用屬性,並以 END:VCARD 結尾。空的選用欄位會省略,而不會以內容模糊的空白屬性顯示。

IANA vCard 元素登錄錄記載了更廣泛的標準詞彙。本產生器刻意採用較小且保守的屬性集合,而非試圖納入不同聯絡人應用程式可能支援的每項擴充功能。

讓每個欄位都對應至實用的聯絡人記錄

完整名稱為必填欄位,因為沒有格式化名稱的可攜式聯絡檔案並不實用。組織、職稱、電子郵件地址、電話號碼、網站與備註均為選用,因此只應納入你預計分享的記錄所需的詳細資料。

輸入欄位需求檢查重點
完整名稱必填拼寫、標點符號,以及名稱的儲存順序
組織選用公司或群組的完整名稱
職稱選用此職稱是否適用於這位聯絡人
電子郵件地址選用完整網域及任何預定使用的加號位址
電話號碼選用國碼、標點符號及預定格式
網站選用通訊協定、網域、路徑,以及是否未包含認證資訊
備註選用完整內容、換行、標點符號及實用長度

長文字並非沒有上限。產生器會拒絕不支援的控制字元,並對聯絡人欄位套用實用的長度限制。網站項目必須使用公開的 HTTP 或 HTTPS URL,且不得包含內嵌的使用者名稱與密碼。備註內的換行符號仍屬於該屬性值的一部分,而不會變成額外的 vCard 記錄。

一般國際文字、標點符號、電話格式與備註都會保留。本工具不會驗證電子郵件地址或電話號碼是否屬於特定個人,只會將你提供的值序列化。

建立並檢視 vCard

  1. 輸入完整名稱。使用聯絡人的格式化名稱所需名稱欄位。這會成為記錄中明確的 FN 屬性。
  2. 加入所需的選用詳細資料。只有當組織、職稱、電子郵件地址、電話號碼、網站或備註確實適合放入名片時才加入。將未使用的欄位留空,以便省略。
  3. 選擇建立 vCard。產生器會將所提供的值序列化為 vCard 4.0 記錄,並在預覽區顯示實際產生的文字。
  4. 檢查預覽內容是否正確。確認名稱拼寫、電話國碼、電子郵件網域、網站路徑與備註文字。反斜線及折行是有效 vCard 序列化的預期組成部分,不應手動移除。
  5. 下載 .vcf 檔案。下載檔案是透過暫時性的瀏覽器 Blob,依預覽內容組合而成。關閉或重新載入頁面前,請先儲存檔案。
  6. 在目標聯絡人應用程式中測試匯入檔案。將 .vcf 傳送給其他人之前,請先確認聯絡人如預期般顯示。

在不變更編碼的情況下閱讀預覽

請以「Doe, Jane」等名稱為例思考。逗號在 vCard 文字中可能具有結構意義,因此必要時產生器會對其進行逸出。預覽中可見的反斜線是保護性語法,並非對該人員名稱多加的內容。分號、反斜線與換行符號也都會接受相同的審慎處理。

長值會透過兩個層次處理。邏輯值仍是單一的聯絡人值,而序列化表示則會跨實體行折行。每個續行都會以一個空格開頭,讓匯入程式能辨識續行並重建原始值。匯入程式會在匯入期間展開這些行並解碼逸出文字。

請勿刪除看似多餘的反斜線,也不要手動合併下載檔案中折行的內容。這些特徵是符合標準的輸出的一部分,而非顯示artifact。由於結果是純文字,你也可以在排除問題時使用文字編輯器檢視。檔案本身只包含聯絡人資料,而不含字型大小、顏色或其他視覺樣式,因此若要求可見的超大字樣,就需要使用不同的輸出格式。

在目標應用程式中測試 .vcf

許多通訊錄與聯絡人應用程式都能匯入 .vcf 檔案,但其匯入行為與選用屬性支援可能各不相同。實際匯入才是最終的相容性檢查。

  1. 找出下載的 .vcf 檔案。保持產生的檔案完整,使用下載的副本,而非手動重建的版本。
  2. 開啟目標應用程式的匯入指令。使用其文件中提供的選項,匯入 vCard 或聯絡人檔案。
  3. 選擇 .vcf,並在可能的情況下匯入測試聯絡人。如此較容易比較匯入的欄位,而不會與現有記錄混淆。
  4. 比較匯入的詳細資料。先檢查完整名稱,再依序檢查你納入的組織、職稱、電子郵件、電話、網站與備註。
  5. 調查預覽中選用欄位的差異。如果匯入後缺少某個欄位,請確認它是否出現在產生的文字中。不同應用程式可能不會顯示或保留每項選用的 vCard 屬性。

如果應用程式拒絕該記錄,請確認下載的檔案未被修改,並檢查預覽以確認輸入正確。產生器遵循 vCard 4.0 的核心規則,但匯入程式仍可能有自己的限制。乾淨匯入 vCard 的實用指南提供了更多常見相容性問題的檢查方式。

瞭解隱私、分享與輸出限制

所有處理都在目前的瀏覽器中進行。聯絡資料不會提交給 Lizely、不會儲存在帳戶中,也不會傳送至遠端轉換服務。下載檔案使用依預覽內容組合而成的暫時性本機 Blob。關閉或重新載入頁面會捨棄輸入的資料與產生的下載檔案,因此離開前請先儲存 .vcf。

此聚焦輸出不會嵌入相片、社交個人資料欄位、同步擴充功能或其他供應商專屬屬性。它也不是數位身分、經驗證的簽章,或提供詳細資料確實屬於真實個人的證據。分享他人的聯絡資訊時,請務必取得適當同意。

對於需要可下載聯絡人記錄的目標,支援的工作流程會以檢視過的 .vcf 與測試匯入作結。若要為簡短的公開值建立可掃描的表示方式,應使用專用的 QR Code 產生器;本工具會直接產生聯絡人檔案,而不是將其轉換為 QR code。

如需深入瞭解,請參閱Is Mind Map Maker Safe? Local Processing and Safe SVG。