iconv – 文字コード（エンコーディング）を変換する

コマンドリファレンス

2025.08.242026.04.29

iconv はテキストファイルの文字コード変換を行うコマンドです。-f（入力側）と -t（出力側）でエンコーディングを指定し、//TRANSLIT や //IGNORE といった修飾子で変換不能文字の扱いも制御できます。
実務では「Shift_JIS を UTF-8 に統一」「ASCII へ近似変換」「壊れたバイト列の除去」などに使います。

構文（Syntax）
主なオプション一覧
実行例
関連コマンド
備考
参考
関連記事

構文（Syntax）

# 基本
iconv [OPTIONS] [-f FROMCODE] [-t TOCODE] [FILE...]

# 代表的な修飾子（主に GNU libiconv）
#   TOCODE に付ける：UTF-8//TRANSLIT, UTF-8//IGNORE など
#   //TRANSLIT : 近似文字に置換（例: ü -> u"）
#   //IGNORE   : 変換不能文字を破棄

主なオプション一覧

オプション	説明	使用例
`-f, --from-code FROM`	入力の文字コードを指定	`iconv -f SHIFT_JIS -t UTF-8 in.txt`
`-t, --to-code TO`	出力の文字コードを指定（`//TRANSLIT`, `//IGNORE` 可）	`iconv -f UTF-8 -t ASCII//TRANSLIT in.txt`
`-o, --output FILE`	出力ファイルを指定（リダイレクトの代替）	`iconv -f SJIS -t UTF-8 -o out.txt in.txt`
`-l, --list`	サポートする符号化名の一覧を表示	`iconv -l`
`-c`	変換不能文字を無視（破棄）	`iconv -f EUC-JP -t UTF-8 -c in.txt`
`-s, --silent`	エラー時も黙って終了（警告抑制）	`iconv -s -f SJIS -t UTF-8 in.txt`
`--byte-subst=STR`	変換不能バイトを `STR` に置換	`iconv -f SJIS -t UTF-8 --byte-subst='�' in.txt`
`--unicode-subst=STR`	変換不能のユニコードを `STR` に置換	`iconv -f UTF-8 -t SJIS --unicode-subst='?' in.txt`
`--help`, `--version`	ヘルプ/バージョン表示	`iconv --version`

変換不能文字の扱いは実装依存です。GNU libiconv/GLIBC では //TRANSLIT///IGNORE が広く使えます。macOS/BSD でもほぼ同様ですが細部は異なる場合があります。

実行例

Shift_JIS → UTF-8 に変換（基本）

説明: 日本語テキストを UTF-8 に統一します。
コマンド:

iconv -f SHIFT_JIS -t UTF-8 input_sjis.txt > output_utf8.txt

ASCII へ “近似変換” する（ウムラウト等を代替）

説明: 非ASCII を似た文字に置換して ASCII に落とします。
コマンド:

iconv -f UTF-8 -t ASCII//TRANSLIT names.txt > names_ascii.txt

壊れたバイト列を無視して通す

説明: 不正なシーケンスで停止させたくない場合に。
コマンド:

iconv -f EUC-JP -t UTF-8//IGNORE raw.log > cleaned.log

一括変換（拡張子ごとに）

説明: ディレクトリ内の .txt を UTF-8 へ。
コマンド:

for f in *.txt; do iconv -f CP932 -t UTF-8 "$f" > "${f%.txt}.utf8.txt"; done

エラー例：不正バイトで失敗

説明: 入力の実際の符号化と -f が合わないとエラーになります。
コマンド:

printf '\xff' | iconv -f UTF-8 -t ASCII

出力例（例）:

iconv: illegal input sequence at position 1

対処: 正しい -f を指定する、//IGNORE や -c / 置換オプションを使う。

備考

自動判定はしない: iconv は入力の符号化を推測しません。必ず正しい -f を指定してください。
修飾子の付け方: //TRANSLIT///IGNORE は TO 側に付けるのが一般的（例: -t UTF-8//IGNORE）。
実装差: GNU libiconv / glibc の iconv(1) と、macOS/BSD や BusyBox 版では対応エンコーディングやオプションが一部異なります。動作が合わない場合は iconv -l や man iconv を確認。
エンコーディング名の別名: CP932 と SHIFT_JIS、SJIS など同義の別名が存在します。iconv -l で受け付ける名称を把握しておくと安全です。
インプレース風に書き換えたい: 直接は不可。moreutils の sponge を併用（例: iconv ... file | sponge file）か、テンポラリへ出力して置換します。
パイプ/ストリーム: 標準入力/出力で動かすと大きなファイルでも無駄な一時ファイルを作らずに処理できます。

参考

GNU libiconv（公式）: https://www.gnu.org/software/libiconv/
GNU libiconv マニュアル（iconv(1)）: https://www.gnu.org/software/libiconv/manual/html_node/iconv-Invocation.html
Linux man-pages iconv(1)（コマンド）: https://man7.org/linux/man-pages/man1/iconv.1.html
Linux man-pages iconv(3)（ライブラリ関数の概要）: https://man7.org/linux/man-pages/man3/iconv.3.html
FreeBSD iconv(1)（実装差の確認に）: https://man.freebsd.org/cgi/man.cgi?iconv(1)
BusyBox iconv（簡易版）: https://busybox.net/downloads/BusyBox.html