macOS / APFSのファイル名・パス制限
本サイトは「このファイル名やパスが使えるか」を判定しません。掲載しているのは、公式資料に何が書かれているかの要約です。利用前に必ず原典をご確認ください。
区分: ファイルシステム
7項目ごとの状況
禁止文字
ファイル名に使用できない文字
NULと/のみ。Apple File System Reference.pdf本文にも文字種以外の禁止文字一覧はない POSIX由来
shall not contain the <NUL> or <slash>
Apple File System Reference(2020-06-22版)にも禁止文字の一覧は無く、名前は null 終端の UTF-8 文字列とだけ規定されている
出典: POSIX.1-2017 §3.170 Filename
確認日: 2026年10月11日
予約名
CON/PRN/AUX/NUL/COM1-9/LPT1-9 等、特別な意味を持つため使用できない名前
公式記載なし
Apple File System Reference(PDF)に予約名の記載は無い
出典: Apple File System Reference (PDF)
確認日: 2026年10月11日
ファイル名の長さ上限
ディレクトリを含まない、ファイル名単体の上限
未確認
The length includes the final null
この10ビット長フィールドを持つのはハッシュ付きの j_drec_hashed_key_t のみ。非ハッシュ型 j_drec_key_t(uint16_t、10ビットマスクなし)がどの条件で使われるかは Apple File System Reference に書かれていないため、確定値とせず未確認としている(広く言われる255文字という数値にも、このPDFは触れていない)
出典: Apple File System Reference (PDF), p.78-79
確認日: 2026年10月11日
パス長の上限
ディレクトリを含む、パス全体の上限
{PATH_MAX}バイト(終端NUL含む、数値は実装依存) (単位: バイト) POSIX由来
may be limited to {PATH_MAX} bytes
Apple File System Reference.pdf自体にはパス長の定義はない(オンディスク構造の文書のため対象外)
出典: POSIX.1-2017 §3.271 Pathname
確認日: 2026年10月11日
大文字小文字の区別
大文字と小文字を別のファイル名として区別するか
macOSでは既定は非区別(区別するvariantも存在)。iOSでは区別
case-insensitive being the default
Apple File System Reference にも、ボリュームの機能フラグ APFS_INCOMPAT_CASE_INSENSITIVE(大文字小文字を区別しないボリューム)の定義がある
出典: Apple Developer - APFS Guide FAQ (Retired Document, Updated 2018-06-04)
確認日: 2026年10月11日
Unicode正規化
ファイル名の保存時にNFC/NFD等の正規化を行うか
正規化非依存(normalization-insensitive)だが正規化形を保持(preserving)。ハッシュ計算時のみNFD(正準分解)を使用
using a hash-based native normalization
Apple File System Reference にも、名前のハッシュを計算するときだけ NFD(canonical decomposition)で正規化し、名前自体は UTF-8 文字列のまま格納する旨の記載がある。正規化した形でディスクに格納する HFS+ との違いに注意
出典: Apple Developer - APFS Guide FAQ (Retired Document)
確認日: 2026年10月11日
末尾のドット・空白
ファイル名の末尾にドットや空白を使用できるか
NULと/以外を禁じる規定はなく、末尾ドット・空白を禁じる規定もない POSIX由来
shall not contain the <NUL> or <slash>
Apple File System Reference.pdf自体にも末尾ドット・空白を禁じる規定はない
出典: POSIX.1-2017 §3.170 Filename
確認日: 2026年10月11日
出典一覧
このページを引用する場合
本ページの情報を引用・紹介いただく場合は、ページ名「macOS / APFSのファイル名・パス制限」と情報確認日「2026年10月11日」をあわせてお示しください。当ページへのリンクは任意です(リンクいただける場合は https://www.conbu.jp/tool/filename-limits/macos-apfs.html をご利用ください)。
免責事項: 本ページはmacOS / APFSを提供・管理する組織の公式サイトではなく、「このファイル名やパスを使ってよいか」を判定するものでもありません。掲載している内容は調査時点で公式資料から確認できた要約です。仕様は改定されうるため、最新の内容は必ず出典元の原典でご確認ください。詳細は免責事項をご確認ください。