Python中原始字符串(r前綴)的作用及用法

更新時(shí)間：2026年05月11日 09:29:35 作者：IT之一小佬

本文解釋了在Python中使用原始字符串（r）處理文件路徑的重要性,避免了轉(zhuǎn)義字符沖突的問題,同時(shí),介紹了三種替代寫法,并在正則表達(dá)式中強(qiáng)調(diào)了r前綴的使用,需要的朋友可以參考下

一、核心概念：什么是原始字符串？

在Python中，字符串前的 r 告訴解釋器：“**請將這個(gè)字符串中的所有內(nèi)容都視為普通字符，不要進(jìn)行任何轉(zhuǎn)義處理。”**

要理解這一點(diǎn)，我們需要先看看如果沒有 r 會(huì)發(fā)生什么。

二、為什么需要r？—— 轉(zhuǎn)義字符的“鍋”

在標(biāo)準(zhǔn)的Python字符串中，反斜杠 \ 是一個(gè)特殊的轉(zhuǎn)義字符。它用來表示一些無法直接輸入的字符，例如：

\n 代表換行符
\t 代表制表符
" 代表雙引號本身

問題的根源Windows系統(tǒng)的文件路徑也是用反斜杠 \ 作為分隔符的。當(dāng)你寫下這樣的代碼時(shí)：

#  錯(cuò)誤示范：沒有加 r
path = "E:\python_code\test\003\data"

Python解釋器在解析這個(gè)字符串時(shí)，會(huì)嘗試把 \ 和后面的字母組合起來看是否是特殊字符。雖然 \p、\t（test）、\d（data）在標(biāo)準(zhǔn)Python中可能不會(huì)報(bào)錯(cuò)（會(huì)被當(dāng)作普通字符處理），但如果你的路徑中包含以下字母，就會(huì)引發(fā)嚴(yán)重的語法錯(cuò)誤或邏輯錯(cuò)誤：

\n：Python會(huì)把它當(dāng)成換行符。
\t：Python會(huì)把它當(dāng)成制表符（Tab）。
\r：Python會(huì)把它當(dāng)成回車符。
\U 或 \u：Python會(huì)嘗試將其解析為Unicode編碼，如果后面格式不對，直接報(bào)錯(cuò) SyntaxError: (unicode error)。

報(bào)錯(cuò)案例假設(shè)你的路徑是 C:\Users\Name\Desktop，代碼寫成：

path = "C:\Users\Name\Desktop"

Python看到 \U，會(huì)試圖解析后面的字符為Unicode長整型轉(zhuǎn)義，結(jié)果發(fā)現(xiàn)格式不對，直接拋出異常，程序無法運(yùn)行。

三、解決方案：r的三種替代寫法

為了確保路徑字符串中的 \ 僅僅是一個(gè)普通的分隔符，我們有三種常見的寫法。

方法1：使用原始字符串（加 r**）—— 最推薦**這是最簡潔、最符合Windows用戶習(xí)慣的寫法。你只需要在引號前加一個(gè) r。

#  推薦寫法
sourcepath = r"E:\python_code\test\003\data"

優(yōu)點(diǎn)：直接復(fù)制Windows資源管理器的路徑即可，無需修改，可讀性最強(qiáng)。
適用：絕大多數(shù)Windows文件路徑場景。

方法2：使用雙反斜杠 \既然單個(gè) \ 是轉(zhuǎn)義符，那么用兩個(gè) \ 就可以表示一個(gè)普通的反斜杠。第一個(gè) \ 轉(zhuǎn)義了第二個(gè) \。

#  可行寫法
sourcepath = "E:\\python_code\\test\\003\\data"

優(yōu)點(diǎn)：這是許多編程語言通用的標(biāo)準(zhǔn)寫法，兼容性極好。
缺點(diǎn)：寫起來麻煩，路徑長的時(shí)候看著眼花（“反斜杠地獄”）。

方法3：使用正斜杠 /Python在內(nèi)部處理路徑時(shí)，完全兼容Linux風(fēng)格的正斜杠 /，即使在Windows系統(tǒng)上也是如此。

#  可行寫法
sourcepath = "E:/python_code/test/003/data"

優(yōu)點(diǎn)：跨平臺兼容性好（Windows和Linux通用）。
缺點(diǎn)：不符合Windows用戶的視覺習(xí)慣。

四、效果對比演示

讓我們通過代碼來看看區(qū)別：

import os

# 1. 普通字符串（假設(shè)路徑包含 \n）
# 這里的 \n 會(huì)被解析為換行符，導(dǎo)致路徑無效
bad_path = "C:\new_folder\test.txt" 
print(f"普通字符串長度: {len(bad_path)}") # 長度變短了，因?yàn)?\n 算1個(gè)字符

# 2. 原始字符串（加 r）
# 這里的 \n 被解析為兩個(gè)字符：反斜杠和字母n
good_path = r"C:\new_folder\test.txt"
print(f"原始字符串長度: {len(good_path)}") # 長度正常

# 驗(yàn)證路徑是否存在（假設(shè)文件存在）
# os.path.exists(good_path) -> True

五、拓展應(yīng)用：正則表達(dá)式

除了文件路徑，r 前綴在正則表達(dá)式中也是標(biāo)配。

正則表達(dá)式中也有大量的反斜杠（如 \d 匹配數(shù)字，\w 匹配字符）。如果不加 r，你需要寫四個(gè)反斜杠 \\ 才能匹配一個(gè)普通的反斜杠，代碼將變得無法閱讀。

import re

# 推薦寫法：清晰直觀
pattern = r"\d+\.\d+" 

# 不推薦寫法：難以閱讀
pattern = "\\d+\\.\\d+"

六、總結(jié)

寫法	示例	評價(jià)
原始字符串 (r)	r"C:\Path\To\File"	最推薦，簡潔不易錯(cuò)
雙反斜杠	"C:\Path\To\File"	標(biāo)準(zhǔn)但繁瑣
正斜杠	"C:/Path/To/File"	跨平臺友好
普通字符串	"C:\Path\To\File"	? 極度危險(xiǎn)，容易觸發(fā)轉(zhuǎn)義報(bào)錯(cuò)