你用 Python 生成一段脚本内容，或者在自己的代码里写了一个 Windows 路径，运行直接报语法错误，报的还是一条看不懂的 unicodeescape。你盯着那行代码，路径明明是复制粘贴过来的，绝对没错。
现象
SyntaxError: (unicode error) 'unicodeescape' codec can't decode bytes in position 2-3:
truncated \uXXXX escape
或者：
SyntaxError: (unicode error) 'unicodeescape' codec can't decode bytes
报错会指到你写路径的那一行，甚至精确到某个位置（比如 position 2-3）。但路径本身是合法存在的、能正常打开的，所以你会觉得「见鬼了」。
根因
根因是 Python 字符串里的反斜杠 \ 是转义符。
在普通字符串（不是原始字符串）里，反斜杠有特殊含义，它和后面的字符组成一个「转义序列」：
\n→ 换行\t→ 制表符\\→ 一个字面反斜杠\uXXXX→ 一个 Unicode 码位（后面必须紧跟 4 位十六进制）\xXX→ 一个字节
现在看你写的路径。假设路径是 E:\某个目录\文件：
\某不是合法的转义序列，Python 会给出警告或直接报错；- 更典型的是路径里出现
\u，比如E:\users\...或E:\update\...。
当 \u 后面跟的不是 4 位十六进制数字时，Python 就抛 truncated \uXXXX escape——意思就是「你说要开始一个 \u 转义，但后面没给够 4 位十六进制」。
所以问题不是路径写错了，而是路径里的反斜杠被当成转义符消费掉了。
解决
有三种办法，任选其一。
方法一：用原始字符串 r'...'（最推荐）。
path = r'E:\某个目录\文件.txt'
r 前缀告诉 Python：这个字符串里，反斜杠不是转义符，就是字面反斜杠。 这是写 Windows 路径最干净的方式。
方法二：把反斜杠翻倍 \\。
path = 'E:\\某个目录\\文件.txt'
每个 \\ 表示一个字面反斜杠。能用，但路径一长就非常难读。
方法三：统一用正斜杠 /。
path = 'E:/某个目录/文件.txt'
Windows 的 API 既接受正斜杠也接受反斜杠，而正斜杠在 Python 里不是转义符，写起来最省心。跨平台场景（比如路径也要在 Linux 上跑）尤其推荐这种。
延伸与预防
一个直接的记忆法则：
凡是把路径写进代码字符串，先想一下转义。
这条坑的适用范围比「写路径」宽得多。任何含反斜杠的字符串都适用——正则表达式是最典型的另一个重灾区：
import re
# 想匹配一个数字，写成 '\d' 会触发转义警告或错误
pattern = r'\d+' # 正确：用原始字符串
正则里到处都是 \d、\w、\s 这类转义，写正则一律用原始字符串 r'...'，几乎成了 Python 社区的默认规矩。
另一个稳妥的做法是：路径不硬编码，用 os.path 或 pathlib 来拼，彻底绕开转义问题：
from pathlib import Path
path = Path('E:/某个目录') / '文件.txt' # 用 / 拼接，平台无关
pathlib 的好处是，拼接用 / 运算符，既不用管转义，又自动处理平台差异。
还要小心一个**「当时能跑、改一下就崩」的陷阱：有时你写的 \t、\n、\f 恰好是合法转义，代码不报错，但字符串已经被改成了制表符或换行——于是路径静默地变成了别的东西。比如 E:\temp\data，\t 被解释成制表符，路径实际变成了「E: + 制表符 + emp\data」，字符串合法但完全不是你想要的。这类错误不抛异常**，比 \u 那种直接报错更难发现，因为它只是让程序去找一个不存在的文件。防范方式一样：路径一律用原始字符串或正斜杠。
排查提示：看到 SyntaxError 而不是运行时异常，说明问题在解析阶段就发生了——字符串本身没法被正确读成字符串。这时先检查「有没有反斜杠」，几乎不会错。报错里的 unicodeescape 就是最明确的信号。反过来说，如果程序能跑、只是找不到文件，也要回头想想：是不是某个反斜杠被悄悄转义成了别的字符。