結論

VCFファイルは、名前・電話番号・メールアドレスなどの連絡先を入れた「vCard」形式のテキストファイルです。いちばん手早い取り込み方は、iPhone ならメールやメッセージの .vcf 添付をタップ、Android なら Google 連絡帳の「整理」→「ファイルからインポート」、パソコンなら Google コンタクトの「インポート」です。

この記事でわかること

  • iPhone・Android・Google・Outlook・Mac での取り込み方と書き出し方(公式の手順)
  • vCard 2.1・3.0・4.0 の違いと、文字化け(文字コード・Quoted-Printable)の原因を再現した実物
  • Python で VCF を作って読み戻すコード、複数件の分け方、CSV との相互変換

2026年11月13日更新|Python 3.13.18・vobject 0.9.9・file 5.45 で作成と読み込みを実行

VCF は、連絡先アプリから書き出し、別のアプリや端末で取り込むための「受け渡し用のファイル」です。どのアプリも同じ形式を読み書きできるため、機種変更や、メールで連絡先を1件だけ送る場面で使われます。

flowchart LR
    V[連絡先アプリが<br>書き出した .vcf<br>vCard 2.1/3.0/4.0] --> I[iPhone<br>添付をタップ]
    V --> N[Android<br>ファイルからインポート]
    V --> G[Google コンタクト<br>インポート]
    V --> O[Outlook<br>CSV を経由して取り込む]

よく調べられることの答えを先にまとめます。

やりたいこと いちばん早い方法 詳しい節
VCFファイルとは何か知りたい 連絡先を入れた vCard 形式のテキスト。1件は BEGIN:VCARD〜END:VCARD VCFファイル(vCard)とは
iPhone に VCF を取り込む メール・メッセージの .vcf 添付をタップする iPhone・Mac・iCloud.com
Android に VCF を取り込む 連絡帳アプリの「整理」→「ファイルからインポート」 AndroidとGoogle コンタクト
Google コンタクトに VCF をインポート パソコンで「インポート」→「ファイルを選択」。1回3,000件まで AndroidとGoogle コンタクト
Outlook に VCF を取り込む 1件は添付を開いて保存。まとめては CSV に変えて取り込む Outlook と Windows
VCF が文字化けする 2.1 の文字コード指定(CHARSET)を確かめ、3.0・4.0(UTF-8)で出し直す 文字化けの原因と直し方
VCF を自分で作る Python で BEGIN〜END を CRLF 区切りで書く(コードあり) VCFファイルの作り方
VCF と CSV を変換する Python の csv モジュールで相互に変換(実物あり) VCFとCSVの違い・変換

確認環境:Ubuntu 24.04.5 LTS の作業用フォルダーで、Python 3.13.18 の標準ライブラリだけで vCard 2.1(UTF-8 と Shift_JIS の Quoted-Printable、Shift_JIS の生のバイト)・3.0・4.0 のファイルを架空の連絡先で作り、先頭のバイトを od と Python で16進表示し、file 5.45 で形式の判定を確かめました。読み戻しは自作の読み込み関数と、PyPI の vobject 0.9.9 の両方で行い、BOM つき・LF 改行・折り返しを誤ったファイル・写真入りのファイル・1万件のファイルも作って、エラーの原文と大きさ・読み込み時間を測っています。iPhone・Android・Mac・Windows・Outlook・Google コンタクト・iCloud.com の手順は、Apple・Google・Microsoft の公式ヘルプで1つずつ確かめた範囲だけを書き、端末やアカウントでの操作はしていません(ログインもしていません)。vCard の決まりは RFC 6350(4.0)と RFC 2426(3.0)の原文で確かめました。図は mermaid で描画を確かめています(確認日 2026年11月13日)。

本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。

(記載例)出典:株式会社RJC「VCFファイル(vCard)とは|iPhone・Android取り込み方と文字化け」

VCFファイル(vCard)とは(意味と使われる場面)

この節では、VCFファイルとvCardの関係と、同じ「VCF」でも別の形式がある点が分かります。

VCF は vCard の拡張子です。 vCard は電子名刺の形式で、IETF の RFC 6350(vCard 4.0)がメディアタイプ text/vcard の拡張子として .vcf と .vcard を登録しています。中身はただのテキストで、1人分の連絡先が BEGIN:VCARD で始まり END:VCARD で終わります。

場面 「VCF」の意味 見分け方
スマホ・メール・連絡先アプリ vCard(電子名刺・連絡先) 1行目が BEGIN:VCARD
遺伝子解析・バイオインフォマティクス Variant Call Format(遺伝子の変異の記録) 1行目が ##fileformat=VCFv4.2 など

手元で両方のファイルを作り、file コマンドで判定させると、次のように別の形式として出ました。拡張子が同じでも、中身の1行目で見分けられます。

$ file contacts.vcf variants.vcf
contacts.vcf: vCard visiting card, version 4.0
variants.vcf: Variant Call Format (VCF) version 4.2, ASCII text

1機種変更・アプリの乗り換え

前の端末の連絡先を .vcf に書き出し、新しい端末やサービスで取り込む。

2連絡先を1件だけ送る

Outlook の「ビジネス カード」の挿入は、vCard をメールに添付する機能(Microsoft の説明)。

3システム間の受け渡し

顧客管理・グループウェア・自作のシステムと、連絡先アプリの間でデータを渡す。

取り込む・書き出すという操作そのものの考え方は、別の記事「インポートとは|エクスポートとの違いと取り込みの失敗例」でも扱っています。

VCFファイルの中身:先頭のバイトと1件の構造を読む

この節では、VCFファイルの先頭のバイト(マジックナンバー)と、1件の連絡先がどう書かれているかが分かります。

vCard には決まったバイナリのマジックナンバーはなく、先頭は文字の BEGIN:VCARD です。 手元で作った vCard 4.0 のファイルを16進で表示すると、ASCII の「BEGIN:VCARD」と改行の 0D 0A(CRLF)が並びます。

$ od -A d -t x1 -N 32 v40.vcf
0000000 42 45 47 49 4e 3a 56 43 41 52 44 0d 0a 56 45 52
0000016 53 49 4f 4e 3a 34 2e 30 0d 0a 46 4e 3a e5 b1 b1
         B  E  G  I  N  :  V  C  A  R  D \r \n  V  E  R ...

17バイト目からの VERSION:4.0 のあと、FN: に続く e5 b1 b1 は「山」の UTF-8 です。同じ連絡先を、いくつかの作り方で保存したときの先頭は次のとおりでした。

ファイル 先頭のバイト(16進) file コマンドの判定
vCard 4.0(CRLF) 42 45 47 49 4E 3A … vCard visiting card, version 4.0
vCard 3.0(CRLF) 42 45 47 49 4E 3A … vCard visiting card, version 3.0
vCard 2.1(Quoted-Printable) 42 45 47 49 4E 3A … vCard visiting card, version 2.1
3.0 を BOM つき UTF-8 で保存 EF BB BF 42 45 47 … Unicode text, UTF-8 (with BOM) text
3.0 を LF 改行で保存 … 44 0A 56 45 52 … lines not separated by CRLF

BOM(先頭の EF BB BF)が付くと、file コマンドは vCard と判定しませんでした。 file --mime-type でも、BOM なしは text/vcard、BOM つきは text/plain でした。メモ帳などで保存し直したファイルが取り込めないときは、この3バイトを疑います。

1件の連絡先の書き方

Python で作った vCard 4.0 の1件です(架空の連絡先)。1行が「項目名;パラメーター:値」の形です。

BEGIN:VCARD
VERSION:4.0
FN:山田 花子
N:山田;花子;;;
ORG:見本商事\, 開発部
TEL;TYPE=cell;VALUE=uri:tel:090-0000-1234
EMAIL:hanako@example.com
NOTE:メモ:会議は火曜。\n資料は共有フォルダー
END:VCARD
項目 意味 書き方の決まり(RFC 6350)
VERSION vCard の版 必須。4.0 では BEGIN の直後に置く
FN 表示する名前 必須(4.0)。3.0 では N も必須
N 分けた名前 姓;名;ミドルネーム;敬称(前);敬称(後)の順。空でも ; は残す
TEL・EMAIL 電話・メール TYPE=cell・TYPE=work などで種類を付ける
ADR 住所 私書箱;建物など;番地;市区町村;都道府県;郵便番号;国 の7つ
NOTE・PHOTO メモ・写真 メモの改行は \n。写真は Base64 などで埋め込む

値の中のカンマ・セミコロン・バックスラッシュは \,・\;・\\ とエスケープします。上の例の 見本商事\, 開発部 は、読み戻すと「見本商事, 開発部」になりました。

vCard 2.1・3.0・4.0の違い(版で変わる文字コード)

この節では、vCard の版ごとの違いと、どの違いが文字化けや取り込みの失敗につながるかが分かります。

日本語で効いてくる違いは「文字コードの指定のしかた」です。 2.1 は項目ごとに CHARSET と ENCODING=QUOTED-PRINTABLE を付けられ、3.0 でどちらも廃止され、4.0 は UTF-8 だけになりました。

観点 2.1 3.0 4.0
仕様・公開 Internet Mail Consortium、1996年9月 RFC 2426、1998年9月 RFC 6350、2011年8月
文字コード 項目ごとに CHARSET= CHARSET パラメーター廃止(外側の MIME で指定) UTF-8 のみ(変更できない)
Quoted-Printable 使える 廃止(バイナリは B のみ) 使わない
必須の項目 N・FN の必須化は 3.0 から(RFC 2426) VERSION・N・FN VERSION・FN
TYPE= の省略 省略できる(TEL;CELL) 必須(TEL;TYPE=CELL) 必須

RFC 2426 の第5節「Differences From vCard v2.1」は、Quoted-Printable の廃止、CHARSET パラメーターの廃止、テキストの改行を \n で書くこと、カンマ・セミコロンのエスケープ、TYPE= の必須化などを並べています。RFC 6350 の付録 A は、4.0 で UTF-8 だけになったこと、KIND・GENDER・ANNIVERSARY などの項目が加わったことを挙げています。

同じ2人分の連絡先を版ごとに書き出すと、大きさは次のようになりました。2.1 の Quoted-Printable は日本語1バイトを =E5 の3文字で書くため、4.0 の約1.5倍になります。

582BvCard 4.0(UTF-8)2件。日本語はそのまま
572BvCard 3.0(UTF-8)主に TEL・TYPE の書き方が違う
890BvCard 2.1(UTF-8・QP)4.0 の1.53倍。Shift_JIS の QP は730B

2.1 の Quoted-Printable の行は、次のように見えます。テキストエディタで開いて =E5=B1=B1 のような文字が並んでいたら 2.1 です。

BEGIN:VCARD
VERSION:2.1
N;CHARSET=UTF-8;ENCODING=QUOTED-PRINTABLE:=E5=B1=B1=E7=94=B0;=E8=8A=B1=E5=AD=90;;;
FN;CHARSET=UTF-8;ENCODING=QUOTED-PRINTABLE:=E5=B1=B1=E7=94=B0=20=E8=8A=B1=E5=AD=90
TEL;CELL:090-0000-1234
EMAIL;INTERNET:hanako@example.com
END:VCARD

Mac の「連絡先」の設定でも版は選べます。Apple の公式ガイドは「vCardのフォーマット」の既定を 3.0 とし、2.1 を選んだときは「vCard 2.1エンコーディング」で文字コードを選ぶ、と説明しています。

iPhone・Mac・iCloud.comでVCFファイルを取り込む・書き出す

この節では、Apple の端末とサービスで VCF を取り込む手順と書き出す手順が、公式の説明どおりに分かります。

iPhone で VCF を取り込むいちばん早い方法は、メールかメッセージに付いた .vcf の添付をタップすることです。 Apple の「iPhoneユーザガイド」の「iPhoneで連絡先を読み込む」は、この1手順で説明しています。

1

iPhone:添付の .vcf をタップする

メールまたはメッセージの .vcf 添付ファイルをタップし、表示された連絡先を保存する。たくさんの連絡先をまとめて入れるなら、下の iCloud.com を使う。

iPhoneユーザガイド(iOS 27 の版)

2

iCloud.com:「追加」→「vCardを読み込む」

パソコンのブラウザで icloud.com/contacts を開き、「追加」ボタンから「vCardを読み込む」を選ぶ。複数の連絡先が入った vCard は、それぞれ別の連絡先として「すべての連絡先」に入る。

iCloud.com ユーザガイド

3

Mac:「ファイル」>「読み込む」

Mac の「連絡先」で「ファイル」>「読み込む」からファイルを選ぶ。vCard の場合は、表示されるダイアログで「追加」をクリックする。

Mac の「連絡先」ユーザガイド

iPhone・Mac・iCloud.com で書き出す

どこで 手順(公式の表記) メモ
iPhone(1件を送る) 連絡先をタップ→「連絡先を共有」→ 共有するフィールドを選ぶ →「メッセージ」「メール」など iPhoneユーザガイドの「連絡先を共有する」
iPhone(リスト単位) 連絡先アプリでリストボタン → リストを長押し →「書き出す」→ フィールドを選んで完了 iOS 27 のユーザガイドの手順
Mac の「連絡先」 「ファイル」>「書き出す」>「vCardを書き出す」→ 場所を選んで「保存」 「メモをvCardに書き出す」「写真をvCardに書き出す」は設定で選ぶ
iCloud.com 「メニューを選択」→「すべての連絡先を選択」→「操作」→「vCardを書き出す」 複数件を選ぶと1つの vCard になる

Apple は、Mac の「連絡先」の vCard をほかのアプリが読み込めない場合の対処として、「連絡先」>「設定」>「vCard」で「2.1」を選んで書き出し直し、終わったら「3.0」に戻す手順を案内しています。取り込み先が 3.0 を読めないときに試す方法です。

AndroidとGoogle コンタクトでVCFを取り込む(3,000件の上限)

この節では、Android の Google 連絡帳アプリとパソコンの Google コンタクトで VCF を取り込む手順と、件数の上限、書き出しの形式の選び方が分かります。

Google の「連絡先 ヘルプ」は、連絡帳アプリの「整理」から「ファイルからインポート」を選ぶ手順を案内しています。

  1. 1連絡帳アプリ(連絡先)を開くGoogle の連絡帳アプリ。メーカー独自の連絡先アプリでは項目名が違うことがある
  2. 2下部の「整理」→「ファイルからインポート」SIM の連絡先なら「整理」→「SIM の管理」
  3. 3保存するアカウントを選ぶ複数のアカウントがあるときに選ぶ。後から探すときに、どのアカウントに入れたかが手がかりになる
  4. 4インポートする VCF ファイルを選ぶダウンロードしたファイルや、Google ドライブなどに置いたファイル

Google のヘルプには、インポートしても元のアカウントから連絡先は消えない、とも書かれています。メールで受け取った .vcf は、先に端末に保存してから、この手順で選びます。

パソコンの Google コンタクトにインポートする

パソコンでは、Google コンタクトの左側の「インポート」→「ファイルを選択」→ ファイルを選んで「インポート」です。 Google のヘルプ「Google コンタクトに連絡先をインポートする」は、読み込める形式を CSV(.csv)と vCard(.vcf)とし、一度にインポートできるのは3,000件まで、連絡先の総数の上限は25,000件と説明しています。

インポート(取り込む)

左側の「インポート」→「ファイルを選択」→「インポート」

メニューが見えないときは左上のメニューアイコン

1回3,000件まで。超えるときはファイルを分ける

エクスポート(書き出す)

「選択の操作」→「すべて」→「その他の操作」→「エクスポート」

Google アカウントへ戻すなら「Google CSV 形式」

ほかのメールアカウントへ渡すなら CSV か vCard

3,000件を超える VCF を分ける方法は、後の「複数件を1つのVCFファイルに入れる・分ける」の節に、実際に1万件を分けた結果と一緒に載せています。

OutlookとWindowsでVCFファイルを開く・取り込む

この節では、Outlook で VCF を1件ずつ取り込む方法と、まとめて取り込むときに CSV を経由する理由が分かります。

Outlook(Microsoft 365・2024・2021・2019・2016)では、受け取った .vcf の添付を開くと連絡先のフォームが開き、そこから保存できます。 一方、Microsoft の「iCloud (vCard .vcf ファイル) から Outlook に連絡先をインポートする」は、PC の Outlook に .vcf をまとめて取り込むには .csv への変換が要る、と説明しています。

1

エクスプローラーで連絡先フォルダーを開く

C:\Users\<ユーザー名>\Contacts に移動し、上部の「インポート」→「vCard (VCF ファイル)」→「インポート」を選ぶ。

Windows の標準機能

2

.vcf を選んで取り込む

ファイルを選んで「開く」。連絡先ごとに確認が出るので「OK」を選び、終わったら「閉じる」。

件数が多いと確認の回数も増える

3

CSV に書き出す

上部の「エクスポート」→「CSV ファイル」→「エクスポート」→「参照」で保存先を決めて「保存」、項目を選んで「完了」。

項目は既定のままが勧められている

4

Outlook に CSV を取り込む

Microsoft の「.csv ファイルから連絡先をインポートする」の手順で取り込む。CSV を表計算ソフトで開いて確かめるときは、見出しの行を変えない。

Outlook のインポート/エクスポート

Outlook から vCard を送る・保存する

  • メールに添付する:「新しい電子メール」→「挿入」>「ビジネス カード」→ 一覧から選ぶか「その他の名刺」。
  • 連絡先を .vcf で保存する:連絡先を開き、「ファイル」タブ >「名前を付けて保存」。

Microsoft のこれらのページは対象を Outlook for Microsoft 365・2024・2021・2019・2016 としており、新しい Outlook for Windows と Outlook on the web の手順は載っていません。新しい Outlook を使っている場合は、Microsoft の公式ヘルプで自分の版の手順を確かめます。

中身を見るだけならテキストエディタ

VCF はテキストなので、Windows のメモ帳や Mac のテキストエディットで開くと中身が読めます。取り込む前に、1行目が BEGIN:VCARD か、VERSION: がいくつか、=E5 のような文字が並んでいないかを見ると、後の文字化けの見当がつきます。ただし、エディタで上書き保存すると改行や BOM が変わることがあるので、見るだけにします。

OS別のVCFファイルの開き方(一覧表)

この節では、Windows・Mac・iPhone・Android のそれぞれで、VCF を開く・取り込む標準の方法が1つの表で分かります。

OS・サービス 1件を開く・取り込む まとめて取り込む 確かめた公式の文書
iPhone メール・メッセージの .vcf をタップ iCloud.com の「vCardを読み込む」 iPhoneユーザガイド・iCloud.com ユーザガイド
Android 連絡帳アプリ「整理」→「ファイルからインポート」 同じ手順(ファイルに複数件) 連絡先 ヘルプ(Android)
Mac 「連絡先」で「ファイル」>「読み込む」 同じ手順 Mac の「連絡先」ユーザガイド
Windows エクスプローラーの連絡先フォルダーで「インポート」 同じ手順(連絡先ごとに確認) Microsoft サポート
Outlook 添付の .vcf を開いて保存 CSV に変えてインポート Microsoft サポート
Google コンタクト 「インポート」→「ファイルを選択」 1回3,000件まで 連絡先 ヘルプ(パソコン)

どの端末でも、連絡先は個人情報です。VCF をオンラインの変換サイトや閲覧サイトに読み込ませると、ファイルを外部に送ることになるので、社外秘の名簿や個人情報の入ったファイルは送らないようにします。 手元で中身を確かめる方法と、変換するコードは次の節に載せています。

VCFファイルの作り方(PythonでvCard 4.0を作って読み戻す)

この節では、外部のライブラリを使わずに VCF を作るコードと、作ったファイルを読み戻した結果が分かります。

VCF は、決まった順に行を並べ、行の終わりを CRLF にし、長い行を75バイトで折り返せば作れます。 次のコードは Python 3.13.18 の標準ライブラリだけで動かしたものです。

import re, quopri

def esc(s):
    # RFC 6350 3.4: \ , ; と改行をエスケープ
    return s.replace('\\', '\\\\').replace(',', '\\,').replace(';', '\\;').replace('\n', '\\n')

def fold(line, limit=75):
    # 75バイトで折り返す。UTF-8の1文字を途中で切らない
    out, cur, first = [], b'', True
    for ch in line:
        cb = ch.encode('utf-8')
        if len(cur) + len(cb) > (limit if first else limit - 1):
            out.append((b'' if first else b' ') + cur)
            cur, first = b'', False
        cur += cb
    out.append((b'' if first else b' ') + cur)
    return b'\r\n'.join(out)

def make_card(fn, family, given, tel=None, email=None, org=None, note=None):
    lines = ['BEGIN:VCARD', 'VERSION:4.0', 'FN:' + esc(fn),
             'N:%s;%s;;;' % (esc(family), esc(given))]
    if org:   lines.append('ORG:' + esc(org))
    if tel:   lines.append('TEL;TYPE=cell;VALUE=uri:tel:' + tel)
    if email: lines.append('EMAIL:' + email)
    if note:  lines.append('NOTE:' + esc(note))
    lines.append('END:VCARD')
    return b''.join(fold(l) + b'\r\n' for l in lines)

def read_cards(path):
    raw = open(path, 'rb').read()
    if raw.startswith(b'\xef\xbb\xbf'):          # BOM を外す
        raw = raw[3:]
    text = raw.decode('latin-1')                  # バイトのまま扱う
    text = re.sub(r'=\r?\n', '', text)            # 2.1 の QP のソフト改行
    text = re.sub(r'\r?\n[ \t]', '', text)        # 折り返しを戻す
    cards, cur = [], None
    for line in re.split(r'\r?\n', text):
        if not line:
            continue
        head, _, val = line.partition(':')
        name, *params = head.split(';')
        name, params = name.upper(), [p.upper() for p in params]
        if name == 'BEGIN':
            cur = {}
            continue
        if name == 'END':
            cards.append(cur)
            continue
        charset = 'utf-8'
        for p in params:
            if p.startswith('CHARSET='):
                charset = {'SHIFT_JIS': 'cp932'}.get(p[8:], p[8:].lower())
        b = val.encode('latin-1')
        if 'ENCODING=QUOTED-PRINTABLE' in params:
            b = quopri.decodestring(b)
        v = b.decode(charset, errors='replace')
        v = re.sub(r'\\([\\,;nN])', lambda m: '\n' if m.group(1) in 'nN' else m.group(1), v)
        cur.setdefault(name, []).append(v)
    return cards

if __name__ == '__main__':
    data = make_card('山田 花子', '山田', '花子', tel='090-0000-1234',
                     email='hanako@example.com', org='見本商事, 開発部',
                     note='メモ:会議は火曜。\n資料は共有フォルダー')
    data += make_card('John Smith', 'Smith', 'John', tel='+1-555-0100')
    open('contacts.vcf', 'wb').write(data)
    print(data.decode('utf-8'))
    for c in read_cards('contacts.vcf'):
        print(c['FN'][0], '|', c.get('TEL'), '|', c.get('ORG'), '|', c.get('NOTE'))

実行すると、2件の VCF(350バイト)ができ、読み戻した結果は次のとおりでした。カンマと改行はエスケープが戻り、元の文字列と一致しています。

$ python3 vcard_tool.py
BEGIN:VCARD
VERSION:4.0
FN:山田 花子
...(中略)
END:VCARD

山田 花子 | ['tel:090-0000-1234'] | ['見本商事, 開発部'] | ['メモ:会議は火曜。\n資料は共有フォルダー']
John Smith | ['tel:+1-555-0100'] | None | None

同じファイルを PyPI の vobject 0.9.9 でも読み、FN が「山田 花子」「John Smith」、NOTE が改行入りの元の文字列として取り出せることを確かめました。この read_cards は 2.1 の Quoted-Printable(UTF-8・Shift_JIS)、BOM つき、LF 改行のファイルも読み戻せました。一方、vobject 0.9.9 は 2.1 の Quoted-Printable の継続行と BOM つきのファイルを読めませんでした(症状表に原文)。ライブラリを使う場合も、扱う版のファイルを少数作って読めるかを確かめてから使うのが無難です。

長い行の折り返しは「バイト」で数える

RFC 6350 は、1行を改行を除いて75オクテット(バイト)以内に折り返し、続きの行の先頭に空白を1つ置く、と定めています。日本語は UTF-8 で1文字3バイトなので、文字数で数えたり、バイトで機械的に切ったりすると壊れます。 1文字を途中で切る折り返しをわざと作り、Python でファイルを UTF-8 として開くと、次のエラーになりました。

$ python3 -c "open('fold_bad.vcf', encoding='utf-8').read()"
UnicodeDecodeError: 'utf-8' codec can't decode byte 0xe9 in position 109: invalid continuation byte

上のコードの fold で折り返した場合は、行の長さが74・73・67バイトになり、ファイル全体を UTF-8 で問題なく開けました。

複数件を1つのVCFファイルに入れる・分ける

この節では、1つの VCF に何件でも入れられる仕組みと、件数ごとの大きさ、3,000件ずつに分けるコードが分かります。

1つの VCF には、BEGIN:VCARD〜END:VCARD のかたまりを続けて書くだけで、複数の連絡先を入れられます。 RFC 6350 の文法でも、vCard のデータは「1つ以上の vcard」と定義されています。件数は grep -c 'BEGIN:VCARD' contacts.vcf で数えられます。

架空の連絡先(表示名・姓名・会社・携帯番号・メール)で件数を変えて作り、上の read_cards で読み込んだ時間を測りました。

件数 ファイルの大きさ 1件あたり 読み込み時間
1 161 B 161.0 B 0.1ms 未満
100 16,370 B 163.7 B 2.0ms
1,000 166,670 B 166.7 B 14.9ms
3,000 506,670 B 168.9 B 42.9ms
10,000 1,696,670 B 169.7 B 134.9ms

写真を入れない連絡先なら1件およそ170バイトで、1万件でも約1.7MBです。Google コンタクトの「1回3,000件まで」に合わせて分けるコードと、その結果です。

data = open('n10000.vcf', 'rb').read()
cards = [c + b'END:VCARD\r\n' for c in data.split(b'END:VCARD\r\n') if c.strip()]
for k in range(0, len(cards), 3000):
    name = f'part{k // 3000 + 1}.vcf'
    part = b''.join(cards[k:k + 3000])
    open(name, 'wb').write(part)
    print(name, len(cards[k:k + 3000]), 'cards', len(part), 'B')
part1.vcf 3000 cards 506670 B
part2.vcf 3000 cards 510000 B
part3.vcf 3000 cards 510000 B
part4.vcf 1000 cards 170000 B

写真を入れると大きさが跳ね上がる

写真は Base64 で文字にして埋め込むため、元の画像より約1.33倍大きくなります。Python で作った PNG を vCard 4.0 の PHOTO:data:image/png;base64,… として入れた結果です(見本の画像は模様が細かく、圧縮が効きにくいものです)。

144B写真なしの1件名前・電話・メールだけ
37.5KB96×96の PNG を入れた1件PNG 26,926B → Base64 35,904文字(1.333倍)
302KB300×300の PNG を入れた1件折り返しで3,928行

写真入りで数千件を書き出すと、メールに添付できない大きさになることがあります。Mac の「連絡先」なら設定の「写真をvCardに書き出す」で写真を外せます。

VCFの文字化けの原因と直し方(版・文字コード・Quoted-Printable)

この節では、VCF の日本語が化ける原因を、実際に化けた文字列と一緒に原因別に見分けられます。

文字化けのほとんどは「書いた側の文字コード」と「読む側が想定した文字コード」の食い違いです。 同じ「山田 花子」を、わざと違う文字コードで読ませた結果を並べます。

状況 画面に出た文字(実物) 原因 直し方
Shift_JIS の VCF を UTF-8 として読んだ �R�c �Ԏq 2.1 の Shift_JIS を、UTF-8 前提のアプリが読んだ CHARSET=SHIFT_JIS を付けるか、UTF-8 で出し直す
UTF-8 の VCF を Shift_JIS として読んだ 螻ア逕ー 闃ア蟄 Shift_JIS 前提の以前のアプリ・ツールで開いた UTF-8 として開く・2.1 なら CHARSET=UTF-8 を付ける
QP を CHARSET なしで西欧の文字コードとして読んだ å±±ç° è±å­ 2.1 の QP に CHARSET が無い CHARSET を付けて書き出し直す
QP を戻さずに表示した =E5=B1=B1=E7=94=B0 2.1 の Quoted-Printable を読めないアプリ 3.0・4.0 で書き出し直す

化けた VCF を直すとき

避けたい化けた文字のまま取り込み、あとから連絡先アプリで1件ずつ打ち直す
→
代わりに書き出した側で版(3.0・4.0)や文字コードを変えて出し直し、少数で試してから全件を取り込む

見分ける問い:「元のアプリで書き出し直せるか」

直す手順

  • 1テキストエディタで VERSION を見る2.1 なら CHARSET と ENCODING=QUOTED-PRINTABLE の有無を見る。3.0・4.0 なら UTF-8 で書かれているはず
  • 2書き出した側で版を変えて出し直すMac の「連絡先」なら「vCardのフォーマット」と「vCard 2.1エンコーディング」。取り込み先が読める版に合わせる
  • 3BOM と改行を確かめる先頭の EF BB BF、LF だけの改行は、エディタで保存し直したときに付きやすい
  • 42〜3件だけで試す全件を入れてから化けに気づくと、取り込んだ連絡先の削除から始めることになる

文字化けそのものの仕組みは、関連記事「文字化けの原因8選|濁点分離・utf8mb4・絵文字の文字数」で扱っています。Quoted-Printable と同じく文字を ASCII に置き換える Base64 は、関連記事「Base64エンコード各言語コード一覧|sha256ハッシュのコマンド早見表」で扱っています。

VCFとCSVの違い・変換(相互変換の実物)

この節では、VCF と CSV の違いと、Python で相互に変換した結果、電話番号の先頭の0が消える落とし穴が分かります。

VCF は1件ごとに項目の数が違ってよい「名刺の束」、CSV は全員が同じ列を持つ「表」です。 電話番号が3つある人も、メモに改行がある人も、VCF ならそのまま入ります。

観点 VCF(vCard) CSV
形 1件ずつ BEGIN〜END。項目の数は人ごとに違ってよい 1行1件。全員が同じ列
決まり RFC 6350(4.0)など。項目名が決まっている 列名はアプリごとに違う
写真・複数の電話 そのまま入る 列を増やすか、入らない
文字コード 4.0 は UTF-8 のみ UTF-8・BOM つき UTF-8・Shift_JIS が混在
表計算ソフトで見る そのままでは1列に詰まる そのまま表になる

VCF → CSV

上の read_cards で2件入りの vCard 4.0 を読み、Python の csv モジュールで BOM つき UTF-8 の CSV にしたコードと結果です。カンマを含む会社名は、csv モジュールが自動で引用符でくくりました。

import csv, io
buf = io.StringIO()
w = csv.writer(buf, lineterminator='\r\n')
w.writerow(['表示名', '姓', '名', '電話', 'メール', '会社'])
for c in read_cards('v40.vcf'):
    n = c['N'][0].split(';')
    w.writerow([c['FN'][0], n[0], n[1], c['TEL'][0].replace('tel:', ''),
                c.get('EMAIL', [''])[0], c.get('ORG', [''])[0].replace(';', ' ')])
open('contacts.csv', 'w', encoding='utf-8-sig', newline='').write(buf.getvalue())
表示名,姓,名,電話,メール,会社
山田 花子,山田,花子,090-0000-1234,hanako@example.com,見本商事株式会社 開発部
John Smith,Smith,John,+1-555-0100,john@example.com,"Example, Inc."

CSV → VCF

import csv, io
src = '姓,名,電話,メール\r\n佐藤,一郎,08000001111,ichiro@example.com\r\n鈴木,次郎,0312345678,jiro@example.com\r\n'
out = b''
for r in csv.DictReader(io.StringIO(src)):
    out += make_card(r['姓'] + ' ' + r['名'], r['姓'], r['名'], tel=r['電話'], email=r['メール'])
open('from_csv.vcf', 'wb').write(out)
print(out.decode('utf-8'))
print('read back TEL:', [c['TEL'][0] for c in read_cards('from_csv.vcf')])
print('int() of 08000001111 ->', int('08000001111'))
BEGIN:VCARD
VERSION:4.0
FN:佐藤 一郎
N:佐藤;一郎;;;
TEL;TYPE=cell;VALUE=uri:tel:08000001111
EMAIL:ichiro@example.com
END:VCARD
(2件目の鈴木 次郎も同じ形のため省略)
read back TEL: ['tel:08000001111', 'tel:0312345678']
int() of 08000001111 -> 8000001111

csv モジュールは値を文字列のまま扱うので、先頭の0は残りました。電話番号を数値として扱うと、08000001111 は 8000001111 になり、先頭の0が消えます。 表計算ソフトで CSV を開いて保存し直したときに起きやすい現象です。

CSV の文字化けと先頭の0の扱いは関連記事「CSV文字化けの直し方|エクセルで今すぐ直す手順とUTF-8で直らない原因」で、Python での CSV の読み書きは関連記事「PythonでCSVを読み書き|コピペ用テンプレートと文字化け対策」で扱っています。

VCFファイルが開けない・取り込めないときの症状表(エラー原文つき)

この節では、VCF が開けない・取り込めない・件数が合わないときに、症状から原因と直し方を引けます。

まず、テキストエディタで中身が読めるか、1行目が BEGIN:VCARD かを確かめます。 そのうえで次の表を見ます。ライブラリのエラーは vobject 0.9.9 と Python 3.13.18 で実際に出したものです。

症状 原因 確かめ方 直し方
1件目で読み込みが止まる。vobject は ParseError: At line 1: Failed to parse line: BEGIN:VCARD 先頭に BOM(EF BB BF)が付いた 16進表示で先頭3バイトを見る BOM なしの UTF-8 で保存し直す
vobject は ParseError: At line 11: Failed to parse line: =E9=96=8B… 2.1 の Quoted-Printable の継続行を、3.0 前提の読み手が読めない VERSION:2.1 と = で終わる行がある 3.0・4.0 で書き出し直す
UnicodeDecodeError: 'utf-8' codec can't decode byte 0xe9 … invalid continuation byte 折り返しで UTF-8 の1文字を途中で切った 長い日本語の行の折り返し位置 バイト単位で、文字の境目で折り返す
日本語が「�」や「螻ア逕ー」になる 文字コードの食い違い VERSION と CHARSET を見る 前の節の文字化けの表
Outlook に1件しか入らない 1件ずつ開く方法で取り込んだ・1件しか書き出していない BEGIN:VCARD の数を数える CSV を経由してまとめて取り込む
Google コンタクトで途中までしか入らない 1回3,000件の上限 件数を数える 3,000件ずつに分ける
取り込めたのに連絡先が見当たらない 別のアカウント(端末内・別の Google アカウント)に保存した 保存先のアカウントの選択 保存先を選び直して取り込む
中身が ##fileformat=VCF… で始まる 連絡先ではなく遺伝子解析の Variant Call Format 1行目を見る 連絡先アプリでは開けない。送り主に確かめる

LF だけの改行(0A)のファイルは、RFC 6350 の決まり(CRLF)からは外れますが、手元の read_cards と vobject 0.9.9 はどちらも読み込めました。改行コードの違いが問題になる場面は、関連記事「Git改行コード設定|autocrlfと.gitattributesの違い」で扱っています。出所の分からない .vcf がメールに付いてきたときは、開く前に送り主に確かめます。

判断表:どの版・どの形式で渡すか

この節では、相手や目的に合わせて、VCF の版と、VCF・CSV のどちらで渡すかを決められます。

場面 勧める形 理由
iPhone・Android・Google の間で移す VCF(各アプリの既定の版) どれも vCard を読み込める。公式の手順がある
以前の端末やアプリが 3.0 を読めない VCF 2.1(CHARSET を付ける) Apple も読めない場合の対処として 2.1 を案内している
自作のシステムで新しく出力する VCF 4.0(UTF-8・CRLF・75バイト折り返し) 文字コードの迷いがない。RFC 6350 が現行の仕様
PC の Outlook にまとめて入れる CSV Microsoft が CSV を経由する手順を案内している
表計算ソフトで一覧にする・確かめる CSV(BOM つき UTF-8) 1行1件の表になる。先頭の0に注意
Google アカウントから Google アカウントへ Google CSV 形式 Google がバックアップ用に案内している形式
写真つきで数千件 写真を外して書き出す・ファイルを分ける 写真1枚で1件が数十KB〜数百KB になる
1

まず版を見る

テキストエディタで VERSION: の行を見る。2.1・3.0・4.0 で直し方が変わる。

1行目の次の行

2

件数を数える

BEGIN:VCARD の数が件数。取り込んだ後の件数と比べる。

grep -c で数えられる

3

少数で試す

2〜3件だけのファイルで取り込みを試し、文字と項目を確かめてから全件。

消す手間を減らす

よくある質問

この節では、VCF について検索で多い疑問への短い答えが分かります。

Q. VCFファイルとvCardは同じものですか?
同じものを指します。vCard が形式の名前、VCF(.vcf)がそのファイルの拡張子です。RFC 6350 は拡張子として .vcf と .vcard を登録しています。

Q. VCFファイルはパソコンでどう開けばいいですか?
中身を見るだけならメモ帳などのテキストエディタで開けます。連絡先として取り込むなら、Google コンタクトの「インポート」、Mac の「連絡先」の「ファイル」>「読み込む」、Windows のエクスプローラーの連絡先フォルダーの「インポート」が公式の方法です。

Q. iPhoneでVCFファイルを開いても1件しか入りません。
まず .vcf の中の BEGIN:VCARD の数を確かめます。複数件をまとめて入れるなら、Apple の案内どおり iCloud.com の「vCardを読み込む」を使うと、それぞれが別の連絡先として入ります。

Q. 1つのVCFファイルに入れられる件数に上限はありますか?
RFC 6350 の形式としての上限はありません。取り込む側には上限があり、Google コンタクトは1回3,000件まで、総数25,000件までと案内しています。

Q. VCFの日本語が文字化けするのはなぜですか?
書いた側と読む側の文字コードが食い違うためです。2.1 では項目ごとの CHARSET と Quoted-Printable が使われ、これを読めない・想定と違うアプリで化けます。3.0・4.0(UTF-8)で書き出し直すのが近道です。

Q. vCard 2.1・3.0・4.0のどれを使えばいいですか?
受け渡しの相手が読める版が第一です。新しく作るなら UTF-8 だけの 4.0、相手が 3.0 を読めないなら 2.1、と決めると迷いません。

Q. VCFをCSVに変換する方法は?
Windows ではエクスプローラーの連絡先フォルダーで vCard をインポートし、CSV にエクスポートする方法を Microsoft が案内しています。プログラムなら、この記事の read_cards と Python の csv モジュールで変換できます。

Q. VCFファイルに写真は入りますか?
入ります。Base64 などで文字にして埋め込むため、手元の測定では元の画像の約1.33倍の大きさになりました。Mac の「連絡先」は「写真をvCardに書き出す」で含めるかを選べます。

Q. Outlookで作ったVCFをiPhoneに入れられますか?
Outlook の「ファイル」タブ >「名前を付けて保存」で .vcf にし、メールで iPhone に送って添付をタップすると取り込めます。iPhone は .vcf の添付をタップして読み込む手順を案内しています。

Q. 中身が「##fileformat=VCF」で始まるファイルは何ですか?
連絡先ではなく、遺伝子の変異を記録する Variant Call Format のファイルです。拡張子は同じ .vcf ですが、連絡先アプリでは開けません。

まとめ

  • VCF は vCard 形式の連絡先ファイルで、1件は BEGIN:VCARD〜END:VCARD。先頭のバイトは文字の「BEGIN:VCARD」(42 45 47 49 4E 3A)。
  • 取り込みの最短は、iPhone は添付をタップ、Android は「整理」→「ファイルからインポート」、パソコンは Google コンタクトの「インポート」(1回3,000件まで)。
  • Outlook にまとめて入れるときは CSV を経由する。Windows の連絡先フォルダーで vCard を取り込み、CSV に書き出す。
  • 文字化けは版と文字コードの食い違い。2.1 の CHARSET・Quoted-Printable を確かめ、3.0・4.0(UTF-8)で出し直す。BOM と、文字の途中で切った折り返しも取り込みの失敗につながった。
  • 自作するなら 4.0・UTF-8・CRLF・75バイト折り返し。この記事のコードで作って読み戻し、vobject でも同じ値が取り出せた。

参考・出典

確認日はいずれも 2026年11月13日です。

  • IETF「RFC 6350 vCard Format Specification」:https://www.rfc-editor.org/rfc/rfc6350
  • IETF「RFC 2426 vCard MIME Directory Profile」(5. Differences From vCard v2.1):https://www.rfc-editor.org/rfc/rfc2426
  • Apple「iPhoneで連絡先を読み込む」:https://support.apple.com/ja-jp/guide/iphone/iph356499f31/ios
  • Apple「iPhoneで連絡先を書き出す」:https://support.apple.com/ja-jp/guide/iphone/iph075ddebf2/ios
  • Apple「iPhoneで連絡先情報を追加する/使用する」:https://support.apple.com/ja-jp/guide/iphone/iph3e0ca2db/ios
  • Apple「iCloud.comの連絡先を読み込む、書き出す、印刷する」:https://support.apple.com/ja-jp/guide/icloud/mmfba748b2/
  • Apple「Macの「連絡先」で連絡先を読み込む」:https://support.apple.com/ja-jp/guide/contacts/adrbk1457/mac
  • Apple「Macの「連絡先」で連絡先を書き出す/アーカイブする」:https://support.apple.com/ja-jp/guide/contacts/adrbdcfd32e6/mac
  • Apple「Macの「連絡先」で「vCard」設定を変更する」:https://support.apple.com/ja-jp/guide/contacts/adrbk1512/mac
  • Apple「アプリでMacの「連絡先」のvCardを読み込むことができない場合」:https://support.apple.com/ja-jp/guide/contacts/adrbk1526/mac
  • Google「Google コンタクトに連絡先をインポートする」(パソコン・Android):https://support.google.com/contacts/answer/15147365?hl=ja
  • Google「連絡先のエクスポート、バックアップ、復元」:https://support.google.com/contacts/answer/7199294?hl=ja
  • Microsoft「iCloud (vCard .vcf ファイル) から Outlook に連絡先をインポートする」:https://support.microsoft.com/ja-jp/outlook/import-contacts-from-icloud-vcard-vcf-file-to-outlook
  • Microsoft「連絡先を vCard として送信して保存する (.vcf ファイル)」:https://support.microsoft.com/ja-jp/outlook/send-and-save-contacts-as-vcards-vcf-files
  • Microsoft「Import vCards to Outlook contacts」:https://support.microsoft.com/en-us/outlook/import-vcards-to-outlook-contacts
  • PyPI「vobject」:https://pypi.org/project/vobject/

本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。

(記載例)出典:株式会社RJC「VCFファイル(vCard)とは|iPhone・Android取り込み方と文字化け」

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。

WE ARE HIRING

RJCで一緒に開発しながら、
成長を楽しみませんか?

RJCは、Web・モバイル・AIを活用した開発プロジェクトで、テックリードやPM・PMOも活躍するシステム開発会社です。会社を知る、待遇を確かめる、話を聞いてみる。気になるところ見てみてください!

  • 127日年間休日
  • 12時間平均残業時間
  • 毎日ガチャ遊びココロも大切にする福利厚生。アマギフなどの賞品ラインナップ!

ほかにも、チケットレストラン、書籍読み放題、2年ごとの慰労報奨(休暇 or 金一封)、11期連続の黒字決算。

ABOUT RJC RJCがどんな会社か知る 考え方、研修、働き方、福利厚生、社員の前職まで。RJCのことが丸わかり! RJC丸わかりページへ JOB DESCRIPTION 仕事内容・待遇を見てみる 仕事内容、給与・待遇、選考の流れ。経験者も未経験も!応募前に知りたいこと、まとめました! 募集要項を見る ENTRY エントリーする エントリーは1〜2分・履歴書不要です。まずは話を聞いてみたい、という方でも歓迎です! エントリーフォームへ

成長のヒミツ、 ぜんぶ丸わかり