一覧には見えているのに、名前で探すと0件——日本語ファイル名の「濁点が分かれている」問題を数えました

#!/usr/bin/env python3
"""NFC と一致しないファイル名を数えて一覧にする。読み取り専用。"""
import os, sys, unicodedata
 
root = sys.argv[1] if len(sys.argv) > 1 else "."
skip = {"node_modules", ".git"}   # 巨大で、日本語名を探す対象でもない
total = non_ascii = decomposed = 0
 
for cur, dirs, files in os.walk(root):
    dirs[:] = [d for d in dirs if d not in skip]   # 降りる前に枝を落とす
    for name in dirs + files:
        total += 1
        if name.isascii():
            continue                               # 英数字だけの名前は対象外
        non_ascii += 1
        if unicodedata.normalize("NFC", name) != name:
            decomposed += 1
            print("NFD:", os.path.join(cur, name))
 
print(f"total={total} non_ascii={non_ascii} decomposed={decomposed}")

import os, unicodedata
 
def find_by_name(root, wanted):
    """NFC/NFD の違いを無視して、名前が一致するパスを返す。"""
    key = unicodedata.normalize("NFC", wanted)
    hits = []
    for cur, dirs, files in os.walk(root):
        for name in files:
            # ディスク上の名前を NFC に揃えてから比べる
            if unicodedata.normalize("NFC", name) == key:
                hits.append(os.path.join(cur, name))
    return hits

#!/usr/bin/env python3
"""NFD の名前を NFC へ改名する。既定は予行で、--apply を付けたときだけ実行。"""
import os, sys, unicodedata
 
root, apply = sys.argv[1], "--apply" in sys.argv
 
# topdown=False: 子から先に直し、親の改名で子のパスが変わるのを避ける
for cur, dirs, files in os.walk(root, topdown=False):
    for name in files + dirs:
        nfc = unicodedata.normalize("NFC", name)
        if nfc == name:
            continue
        src, dst = os.path.join(cur, name), os.path.join(cur, nfc)
        if os.path.exists(dst):            # 同名の NFC があれば上書きしない
            print("SKIP (exists):", dst)
            continue
        print("RENAME" if apply else "DRY-RUN", ascii(name), "->", nfc)
        if apply:
            os.rename(src, dst)

# 名前を NFD に変換して、同じ場所をもう一度探す（ページ.csv の例）
find . -name "$(python3 -c "import unicodedata;print(unicodedata.normalize('NFD','ページ.csv'))")"