Error "(unicode error) 'unicodeescape' codec can't decode bytes in position 2-3:… の原因と解決方法。検証済みの解決コマンド付きで、現象→原因→解決→確認の順に最短で直せます。
このエラーが出ていませんか
Error "(unicode error) 'unicodeescape' codec can't decode bytes in position 2-3: truncated \UXXXXXXXX escape"結論
結論：まずこれで直ります
Pythonの文字列リテラル内でバックスラッシュ（\）はエスケープシーケンスの開始文字として解釈されます。下の解決コマンドを順に実行すれば直ります。
cat > /tmp/repro.py << 'EOF'
# 修正方法1: raw文字列 (r-string) を使う
path1 = r"C:\Users\username\Documents\file.txt"
print(path1)
# 修正方法2: スラッシュをエスケープする
path2 = "C:\\Users\\username\\Documents\\file.txt"
print(path2)
# 修正方法3: フォワードスラッシュを使う
path3 = "C:/Users/username/Documents/file.txt"
print(path3)
EOF
python /tmp/repro.pyどんなエラーか
次の操作を行うと（検証環境: python:3.11）、上記のエラーが発生します。まずは下の再現コマンドで、同じ状況を再現できることを確認してください。
検証環境：python:3.11
cat > /tmp/repro.py << 'EOF'
path = "C:\Users\username\Documents\file.txt"
print(path)
EOF
python /tmp/repro.pyなぜ起きるのか
Pythonの文字列リテラル内でバックスラッシュ（\）はエスケープシーケンスの開始文字として解釈されます。例えば '\n' は改行、'\t' はタブを意味します。Windowsのファイルパスで使われる '\U' や '\u' はUnicodeエスケープシーケンス（\UXXXXXXXX や \uXXXX）として解釈されようとしますが、後続の文字が有効な16進数でない場合、'unicodeescape' コーデックがデコードできずこのエラーが発生します。 根本的な解決策は3つあります： 1. 文字列の前に 'r' を付けてraw文字列にする（r"C:\Users\..."）。raw文字列ではバックスラッシュがエスケープ文字として扱われません。 2. バックスラッシュを二重にしてエスケープする（"C:\\Users\\..."）。 3. Windowsパスでもフォワードスラッシュ（/）を使う。Pythonおよびほとんどの現代的なWindowsAPIはフォワードスラッシュを受け付けます。 raw文字列（方法1）が最も読みやすく推奨されます。
解決手順
cat > /tmp/repro.py << 'EOF'
# 修正方法1: raw文字列 (r-string) を使う
path1 = r"C:\Users\username\Documents\file.txt"
print(path1)
# 修正方法2: スラッシュをエスケープする
path2 = "C:\\Users\\username\\Documents\\file.txt"
print(path2)
# 修正方法3: フォワードスラッシュを使う
path3 = "C:/Users/username/Documents/file.txt"
print(path3)
EOF
python /tmp/repro.py直ったか確認する
python /tmp/repro.py | grep -q 'C:' && echo 'OK' && exit 0 || exit 1動画で見る
この手順でも直らない場合は。
エラー文をそのまま貼り付けて送っていただければ、原因の当たりをつけてお返しします。 ヒアリングは無料です。業務システムの内製化・保守のご相談も受け付けています。
無料相談を申し込む