unicodeescapeエラーの直し方｜Windowsのパス

SyntaxError: (unicode error) 'unicodeescape' codec can't decode bytes in position 2-3: truncated \UXXXXXXXX escape は、文字列に書いた Windows のパスの \U（C:\Users の部分）が、Unicode の文字を表す記号として読まれたときのエラーです。

path = "C:\Users\taro\data.csv"     # ← \U が「\U + 16進数8桁」として読まれる

直し方は、次の3つのどれかです。

確認環境：Python 3.10・3.11・3.12・3.13・3.14 で、エラー文と結果を確かめました（確認日 2026年10月11日）。エラー文は5つの版で同じでした。

なぜ \U でエラーになるのか

Python の文字列の中では、\ は「次の文字と組み合わせて特別な文字を表す」記号（エスケープシーケンス）です。

Python の公式ドキュメントでは、\U のあとには16進数がちょうど8桁、\u のあとには4桁が必要と説明されています。C:\Users の \U のあとは sers なので、8桁に足りず「truncated（途中で切れた）」と表示されます。

パスによって、エラー文が変わる

確認環境で、パスの書き方ごとのエラー文を確かめました。

4つとも (unicode error) 'unicodeescape' で始まり、原因は同じです。position 2-3 は、文字列の中の何文字目でつまずいたか（0 から数える）を表しています。

直し方① raw 文字列（r を付ける）

path = r"C:\Users\taro\data.csv"
print(path)      # C:\Users\taro\data.csv

文字列の前に r を付けると、\ が特別な意味を持たなくなります。 エクスプローラーのアドレスバーからコピーしたパスを、そのまま貼り付けられます。

注意：raw 文字列は \ で終われない

folder = r"C:\Users\taro\"      # 最後が \

SyntaxError: unterminated string literal (detected at line 1); perhaps you escaped the end quote?

raw 文字列でも、最後の \ は閉じる " を打ち消してしまいます（公式ドキュメントにも「raw 文字列は、奇数個の \ で終われない」とあります）。フォルダのパスは、最後の \ を書かないか、pathlib でつなぎます。

直し方② / 区切りにする

path = "C:/Users/taro/data.csv"

/ はエスケープの記号ではないので、エラーになりません。pathlib の PureWindowsPath は、/ 区切りで書いたパスを Windows のパス（C:\Users\taro\data.csv）として扱えることを確認しました。

直し方④ pathlib でつなぐ

from pathlib import Path

base = Path(r"C:\Users\taro")
path = base / "data" / "sales.csv"      # / でつなぐ

パスを文字列の + でつながず、/ 演算子でつなぐと、区切り文字の付け忘れ・付けすぎを防げます。 pathlib の使い方は、既存の記事「Python pathlibの使い方｜ファイル操作逆引き70例と実行結果」で扱っています。

エラーにならずに、パスが壊れる例（要注意）

\U はエラーになるので気づけますが、\n・\t などはエラーにならず、別の文字に変わります。

p = "C:\data\new\test.csv"
print(repr(p), len(p))

'C:\\data\new\test.csv' 18

このパスで open(p) を実行すると、次のように表示されました。

FileNotFoundError: [Errno 2] No such file or directory: 'C:\\data\new\test.csv'

ファイルは存在するのに「見つからない」と表示され、原因に気づきにくい形です。エラー文の中に \n・\t が \\ でなく1本の \ で表示されていたら、文字が変わっています。Windows のパスは、最初から r"..." で書くと、この問題も防げます。

Python 3.12 以降の SyntaxWarning

\d・\w のように、Python が知らない組み合わせは、エラーにならず、そのまま \d として残ります。ただし、版によって警告の出方が違いました。

公式ドキュメントでは、3.12 から SyntaxWarning になり、将来の版では SyntaxError になると説明されています。今は動いていても、警告が出ているパスや正規表現（"\d+" など）は、r"..." に直しておきます。

import re
re.findall("\d+", "a12b3")      # 3.12 以降は SyntaxWarning
re.findall(r"\d+", "a12b3")     # r を付ける

確認の手順（チェックリスト）

よくある質問

Q. 設定ファイルから読み込んだパスでも起きますか。 A. このエラーは、プログラムの中に直接書いた文字列を Python が読むときだけ起きます。テキストファイルに C:\Users\taro\new.csv と書いて読み込むと、\ はそのまま残りました。ただし JSON は JSON のエスケープの規則があり、"C:\Users\taro" と書くと json.load で JSONDecodeError: Invalid \escape になりました。 JSON では "C:\\Users\\taro" と \ を重ねます。

Q. ファイルが見つからないエラーは、別の原因ですか。 A. パスの \ が正しくても、実行した場所（カレントディレクトリ）によって見つからないことがあります。関連記事の「FileNotFoundError: [Errno 2]の直し方｜Python」で扱っています。

まとめ

• C:\Users の \U が、Unicode の文字の記号として読まれたエラー
• 直し方は r"C:\Users\..."、/ 区切り、\\、pathlib
• raw 文字列は \ で終われない
• \n・\t を含むパスは、エラーにならずに壊れる（FileNotFoundError になる）
• 3.12 以降は \d などで SyntaxWarning。将来は SyntaxError になる予定

参考・出典

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

• Python ドキュメント「Lexical analysis」（文字列リテラルとエスケープシーケンス）：https://docs.python.org/3/reference/lexical_analysis.html
• Python ドキュメント「pathlib」：https://docs.python.org/3/library/pathlib.html

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