你在腳本里敲下os.mkdir(data/2025/04/01)然后眼巴巴等著一個(gè)FileNotFoundError這種場(chǎng)面我見(jiàn)過(guò)太多次了。目錄創(chuàng)建是項(xiàng)目里最不起眼的操作但恰恰是它讓不少人的自動(dòng)化任務(wù)在上線(xiàn)第一周就翻車(chē)。今天專(zhuān)門(mén)把os.mkdir()創(chuàng)建單層目錄這件事掰開(kāi)揉碎講一遍它到底能做什么、為什么只能建一層、怎么寫(xiě)才不容易踩坑以及真實(shí)項(xiàng)目里怎么用它準(zhǔn)備目錄結(jié)構(gòu)。這個(gè) API 在 Fine 語(yǔ)言里和 Python 的os模塊行為基本一致用過(guò) Python 的同學(xué)會(huì)覺(jué)得格外熟悉。如果你是剛開(kāi)始接觸腳本開(kāi)發(fā)或者正在寫(xiě)文件上傳、日志歸檔、數(shù)據(jù)同步這類(lèi)需要自動(dòng)建目錄的功能這篇文章可以直接當(dāng)作參考手冊(cè)用。1. os.mkdir() 的核心邏輯單層、單級(jí)、一次一個(gè)目錄1.1 先搞懂“單層目錄”是什么意思單一層目錄的意思很直白一次調(diào)用只創(chuàng)建目標(biāo)路徑里的最后一個(gè)目錄不會(huì)自動(dòng)補(bǔ)齊中間任何一級(jí)父目錄。os.mkdir(output)可以成功因?yàn)楦改夸?已經(jīng)存在os.mkdir(output/2025/01)大概率報(bào)錯(cuò)除非output/2025已經(jīng)提前存在。為什么會(huì)這樣因?yàn)椴僮飨到y(tǒng)創(chuàng)建目錄時(shí)必須先解析目標(biāo)路徑的父目錄。mkdir的全過(guò)程相當(dāng)于系統(tǒng)在對(duì)你說(shuō)你要在output/2025下面創(chuàng)建一個(gè)01目錄但output/2025本身都還不存在我沒(méi)法憑空在不存在的位置里塞東西進(jìn)去。Linux 命令mkdir data和mkdir -p data/year/month的區(qū)別也正是這里不帶-p的普通mkdir就是單層創(chuàng)建帶-p才遞歸補(bǔ)全路徑。我習(xí)慣用一個(gè)類(lèi)比幫助新人理解os.mkdir()像一個(gè)只負(fù)責(zé)蓋某一層樓的建設(shè)隊(duì)你說(shuō)“把第 3 層蓋出來(lái)”它首先要確認(rèn)第 2 層已經(jīng)建好。第 2 層沒(méi)有它就停工并給你一個(gè)錯(cuò)誤單。多級(jí)目錄的遞歸創(chuàng)建對(duì)應(yīng)的是os.makedirs()它會(huì)把整條路徑里缺失的每一層都補(bǔ)齊。1.2 為什么要保留“單層限制”而不是默認(rèn)幫你建好所有層級(jí)很多人第一次遇到FileNotFoundError時(shí)會(huì)覺(jué)得這個(gè)設(shè)計(jì)很蠢“我都明確要建這個(gè)路徑了順手把父目錄也建了不好嗎” 但單層限制不是缺陷而是刻意保留的防御行為。假設(shè)一個(gè)業(yè)務(wù)系統(tǒng)在代碼里隨手寫(xiě)上os.mkdir(臨時(shí)文件/用戶(hù)A/照片)如果系統(tǒng)自動(dòng)創(chuàng)建了整條路徑那么任何一次拼寫(xiě)錯(cuò)誤都可能讓目錄結(jié)構(gòu)失控比如把用戶(hù)A寫(xiě)成了用戶(hù)1系統(tǒng)不會(huì)告訴你有問(wèn)題而是默默生成一個(gè)奇怪的空目錄樹(shù)。顯式的單層創(chuàng)建逼迫開(kāi)發(fā)者必須理清路徑的每一級(jí)代碼評(píng)審時(shí)也更容易看出邏輯漏洞。另外單層創(chuàng)建和 Linux 命令、C 語(yǔ)言的mkdir語(yǔ)義保持了一致這種統(tǒng)一性讓各種語(yǔ)言之間的遷移成本變低。你在 Fine 語(yǔ)言里寫(xiě)目錄邏輯在 Python 里寫(xiě)目錄邏輯甚至在 Shell 腳本里寫(xiě)mkdir底層心智模型完全一致。1.3 什么場(chǎng)景該選它什么場(chǎng)景該換遞歸版本選os.mkdir()的場(chǎng)景很明確你只希望確保某一級(jí)目錄存在而父目錄一定已經(jīng)被其他邏輯創(chuàng)建好了。比如項(xiàng)目啟動(dòng)時(shí)在根目錄下初始化一個(gè).cache文件夾或者數(shù)據(jù)任務(wù)開(kāi)始前確認(rèn)logs/當(dāng)前日期的上一級(jí)logs已經(jīng)存在。需要一口氣創(chuàng)建多級(jí)業(yè)務(wù)路徑時(shí)比如data/2025/04/01/上午批次最合適的方案是os.makedirs(path, exist_okTrue)。這個(gè)函數(shù)內(nèi)部本質(zhì)上就是按層級(jí)逐個(gè)調(diào)用目錄創(chuàng)建邏輯所以理解mkdir的單層行為反而是使用makedirs的前提。我用一個(gè)表格把兩者的差異列清楚對(duì)比項(xiàng)os.mkdir()os.makedirs(path, exist_okTrue)創(chuàng)建層級(jí)只能創(chuàng)建最后一級(jí)自動(dòng)創(chuàng)建所有缺失層級(jí)父目錄不存在拋 FileNotFoundError自動(dòng)補(bǔ)全目錄已存在拋 FileExistsError不報(bào)錯(cuò)exist_okTrue推薦適用確實(shí)只要一層多級(jí)路徑初始化2. 參數(shù)、返回值和跨平臺(tái)行為一次講透2.1 path 參數(shù)不只是字符串os.mkdir()的第一個(gè)參數(shù)是目標(biāo)目錄路徑它接受普通字符串也接受bytes或任何實(shí)現(xiàn)os.PathLike接口的對(duì)象。實(shí)際項(xiàng)目里我更推薦傳pathlib.Path對(duì)象它的Path.mkdir(parentsTrue, exist_okTrue)方法本質(zhì)上是os.makedirs的面向?qū)ο蠓庋b語(yǔ)義更清晰。路徑寫(xiě)法上有個(gè)細(xì)節(jié)需要注意~不會(huì)自動(dòng)展開(kāi)成用戶(hù)主目錄環(huán)境變量也不會(huì)自動(dòng)替換。很多新手以為寫(xiě)os.mkdir(~/workspace/project)會(huì)創(chuàng)建主目錄下的路徑結(jié)果系統(tǒng)把一個(gè)名為~的目錄創(chuàng)建到了當(dāng)前目錄下等發(fā)現(xiàn)問(wèn)題時(shí)項(xiàng)目結(jié)構(gòu)已經(jīng)亂了。要展開(kāi)用戶(hù)目錄就顯式調(diào)用Path.home()要展開(kāi)環(huán)境變量就os.path.expandvars不要指望操作系統(tǒng)替你解析。末尾斜杠也是個(gè)容易忽略的點(diǎn)。os.mkdir(/tmp/test/)在大多數(shù)系統(tǒng)上可以正常工作但路徑尾部多余的分隔符在某些跨平臺(tái)代碼里會(huì)引發(fā)怪異行為。我會(huì)在代碼里統(tǒng)一對(duì)路徑做一次rstrip(/\\)處理或者干脆用Path對(duì)象讓它來(lái)處理路徑分隔符的事情。2.2 mode 參數(shù)的真實(shí)作用比你想的復(fù)雜第二個(gè)參數(shù)mode默認(rèn)值是0o777表示創(chuàng)建出來(lái)的目錄權(quán)限位。但它不是最終實(shí)際權(quán)限因?yàn)橄到y(tǒng)還有一個(gè)umask概念在起作用。最終權(quán)限的計(jì)算方式是mode ~umask。舉例說(shuō)明假設(shè)默認(rèn)umask是0o022你調(diào)用os.mkdir(data, mode0o777)實(shí)際拿到的是0o777 ~0o022等于0o755。也就是說(shuō)當(dāng)前用戶(hù)有讀、寫(xiě)、執(zhí)行權(quán)限組和其他用戶(hù)只有讀和執(zhí)行權(quán)限沒(méi)有寫(xiě)權(quán)限。很多人以為傳了0o777就是全權(quán)限結(jié)果部署到共享服務(wù)器上發(fā)現(xiàn)同事無(wú)法寫(xiě)入目錄排查半天才找到是umask在這里偷偷削了一刀。在 Windows 系統(tǒng)上mode參數(shù)基本被忽略目錄權(quán)限由繼承的 ACL 決定。如果你的代碼需要跨平臺(tái)運(yùn)行在邏輯上不要依賴(lài)mode期望精確控制權(quán)限正確的做法是創(chuàng)建完成后用os.chmod()做權(quán)限調(diào)整并確認(rèn)當(dāng)前平臺(tái)支持這種操作。2.3 dir_fd 參數(shù)和返回值os.mkdir()還有一個(gè)可選參數(shù)dir_fd用于在指定目錄的文件描述符上解析相對(duì)路徑。這個(gè)參數(shù)使用頻率很低常見(jiàn)場(chǎng)景是配合os.open的高級(jí)文件操作。普通業(yè)務(wù)代碼不需要碰它但至少要知道它存在避免看函數(shù)簽名時(shí)一頭霧水。返回值方面成功時(shí)永遠(yuǎn)是None不會(huì)返回任何目錄句柄或狀態(tài)對(duì)象。這也就意味著你不能把os.mkdir()的結(jié)果賦值給某個(gè)變量后去判斷創(chuàng)建成功與否。想確認(rèn)目錄是否創(chuàng)建成功要么創(chuàng)建后再用os.path.isdir()驗(yàn)證一次要么通過(guò)異常機(jī)制感知失敗。對(duì)大多數(shù)場(chǎng)景統(tǒng)一靠try/except處理失敗分支就足夠。2.4 異常全集每個(gè)異常都對(duì)應(yīng)一種經(jīng)典事故異常類(lèi)型典型場(chǎng)景說(shuō)明FileExistsError目標(biāo)目錄已經(jīng)存在重復(fù)運(yùn)行腳本時(shí)最常遇到FileNotFoundError父目錄不存在多級(jí)路徑未補(bǔ)全的經(jīng)典報(bào)錯(cuò)NotADirectoryError路徑中的某一部分是一個(gè)文件創(chuàng)建data/logs/new時(shí)data/logs其實(shí)是文件PermissionError對(duì)父目錄沒(méi)有寫(xiě)權(quán)限共享目錄、只讀掛載盤(pán)是重災(zāi)區(qū)每種異常單獨(dú)拎出來(lái)都能寫(xiě)一篇排查筆記。后面第 4 節(jié)我會(huì)按場(chǎng)景詳細(xì)展開(kāi)這里先記住一個(gè)大原則不要把異常全都吞掉至少要打出日志或做一次目錄檢查否則線(xiàn)上環(huán)境會(huì)變成只看得到結(jié)果錯(cuò)誤、找不到原因的謎題。3. 實(shí)操如何用 os.mkdir() 穩(wěn)妥創(chuàng)建單層目錄3.1 最簡(jiǎn)單直白的判斷寫(xiě)法對(duì)于大多數(shù)不涉及并發(fā)的場(chǎng)景直接在創(chuàng)建前判斷目錄是否存在就夠用。標(biāo)準(zhǔn)寫(xiě)法長(zhǎng)這樣import os dir_path output if not os.path.isdir(dir_path): os.mkdir(dir_path)有人會(huì)寫(xiě)if not os.path.exists(dir_path)這個(gè)寫(xiě)法不夠嚴(yán)謹(jǐn)因?yàn)橥募泊嬖跁r(shí)exists返回 True你跳過(guò)創(chuàng)建后面當(dāng)成目錄用時(shí)就會(huì)報(bào)NotADirectoryError或直接得到錯(cuò)誤行為。判斷目錄存在應(yīng)該用os.path.isdir()它會(huì)同時(shí)確認(rèn)“路徑存在”和“路徑是目錄”兩個(gè)條件。這種寫(xiě)法的優(yōu)點(diǎn)是代碼一眼能看懂適合在初始化腳本、一次性任務(wù)里使用。缺點(diǎn)是“判斷”和“創(chuàng)建”之間存在時(shí)間窗口兩個(gè)進(jìn)程同時(shí)執(zhí)行到這里第一次檢查都沒(méi)發(fā)現(xiàn)目錄然后一起調(diào)用os.mkdir()后到達(dá)的那個(gè)就會(huì)拋FileExistsError這個(gè)問(wèn)題在定時(shí)任務(wù)并發(fā)執(zhí)行時(shí)會(huì)非常明顯。3.2 捕獲異常寫(xiě)法并發(fā)環(huán)境下更可靠更健壯的做法是直接調(diào)用創(chuàng)建讓異常機(jī)制處理沖突import os dir_path output try: os.mkdir(dir_path) except FileExistsError: pass這背后的思路是“先做再驗(yàn)證”把目錄已存在當(dāng)作一種自然狀態(tài)而不是錯(cuò)誤。多個(gè)進(jìn)程同時(shí)創(chuàng)建同一個(gè)目錄時(shí)一個(gè)成功其余的全部進(jìn)異常分支但不會(huì)中斷流程。這種寫(xiě)法也天然處理了“兩次運(yùn)行服務(wù)”的情況服務(wù)重啟后不會(huì)因?yàn)槟夸浺汛嬖诙罎?。需要補(bǔ)充的是只捕獲FileExistsError還不夠如果你接下來(lái)要往這個(gè)目錄里寫(xiě)文件最好在捕獲后補(bǔ)一次目錄檢查try: os.mkdir(dir_path) except FileExistsError: if not os.path.isdir(dir_path): raise ValueError(f{dir_path} 已存在同名文件無(wú)法作為目錄使用)這個(gè)補(bǔ)充非常實(shí)用。某項(xiàng)目里有個(gè)上傳功能第一次創(chuàng)建目錄時(shí)一切正常后來(lái)有人手動(dòng)在上傳目錄旁邊放了個(gè)同名文件程序捕獲到FileExistsError后直接當(dāng)作目錄繼續(xù)用結(jié)果寫(xiě)文件全部失敗。加一次isdir校驗(yàn)問(wèn)題在三行代碼內(nèi)就解決。3.3 工程上更推薦makedirs exist_ok既然os.mkdir()只建一層那為什么實(shí)際代碼里滿(mǎn)大街都是os.makedirs(path, exist_okTrue)因?yàn)榇蠖鄶?shù)業(yè)務(wù)路徑都是多級(jí)的與其一級(jí)一級(jí)自己拼循環(huán)不如把問(wèn)題交給標(biāo)準(zhǔn)庫(kù)import os path data/2025/04/01 os.makedirs(path, exist_okTrue)這段代碼會(huì)依次創(chuàng)建data、data/2025、data/2025/04、data/2025/04/01全部存在時(shí)也不會(huì)報(bào)錯(cuò)。使用exist_okTrue后目錄已存在是一種可接受狀態(tài)但同名文件存在時(shí)依舊會(huì)拋FileExistsError這個(gè)行為和mkdir單層場(chǎng)景一致。理解這一點(diǎn)很重要makedirs不是一種完全不同的能力它本質(zhì)上是把mkdir單層邏輯循環(huán)執(zhí)行只不過(guò)幫你省去了拆解路徑的工作。所以即便你最終決定在項(xiàng)目里統(tǒng)一用makedirs也完全有必要理解單層創(chuàng)建時(shí)的行為和異常語(yǔ)義。3.4 用 pathlib 統(tǒng)一封裝目錄準(zhǔn)備邏輯如果你正在用 Fine 語(yǔ)言的標(biāo)準(zhǔn)庫(kù)很可能會(huì)用pathlib風(fēng)格的路徑對(duì)象。它對(duì)應(yīng)的方法寫(xiě)法如下from pathlib import Path dir_path Path(data/2025/04/01) dir_path.mkdir(parentsTrue, exist_okTrue)parentsTrue對(duì)應(yīng)遞歸創(chuàng)建父目錄exist_okTrue對(duì)應(yīng)目錄已存在時(shí)不拋異常。這個(gè)寫(xiě)法比os.makedirs更推薦因?yàn)镻ath對(duì)象在拼接路徑時(shí)不用手動(dòng)處理斜杠問(wèn)題。比如Path(data) / 2025 / 04不管在 Windows 還是 Linux 上運(yùn)行生成的路徑分隔符都是正確的。我習(xí)慣在項(xiàng)目里沉淀一個(gè)目錄初始化的小工具函數(shù)from pathlib import Path def ensure_dir(path: Path) - Path: if path.exists() and not path.is_dir(): raise NotADirectoryError(f{path} 已存在但不是目錄) path.mkdir(parentsTrue, exist_okTrue) return path這個(gè)函數(shù)把“路徑存在但是文件”“父目錄缺失自動(dòng)補(bǔ)齊”“目錄已存在無(wú)視”三種情況全部處理掉。團(tuán)隊(duì)里所有人只要用到目錄準(zhǔn)備都調(diào)這一個(gè)函數(shù)就不會(huì)有人因?yàn)閛s.mkdir()單層限制寫(xiě)出一個(gè)FileNotFoundError出來(lái)。4. 真實(shí)項(xiàng)目里的目錄流程實(shí)例4.1 按日期生成日志目錄日志歸檔是目錄創(chuàng)建最常見(jiàn)的場(chǎng)景之一。我當(dāng)年接手某數(shù)據(jù)同步項(xiàng)目時(shí)日志目錄按天隔離每天生成logs/2025-04-01這種層級(jí)。第一天沒(méi)問(wèn)題第二天發(fā)現(xiàn)任務(wù)在凌晨零點(diǎn)定時(shí)跑掛了報(bào)錯(cuò)信息正是FileNotFoundError。原因很典型代碼里寫(xiě)的是os.mkdir(Path(logs) / date_str)但logs這個(gè)父目錄是前一天手動(dòng)創(chuàng)建的。到了第二天服務(wù)自動(dòng)啟動(dòng)時(shí)logs已經(jīng)不存在于是單層創(chuàng)建直接失敗。修復(fù)方式是把目錄初始化邏輯提前到每次任務(wù)開(kāi)始時(shí)統(tǒng)一執(zhí)行并且用遞歸創(chuàng)建保證父目錄一定存在from datetime import date from pathlib import Path log_root Path(logs) today_dir log_root / date.today().isoformat() today_dir.mkdir(parentsTrue, exist_okTrue)經(jīng)驗(yàn)是日志目錄的創(chuàng)建不要依賴(lài)“上次服務(wù)運(yùn)行留下的狀態(tài)”。任務(wù)進(jìn)程可能被重啟磁盤(pán)可能被清理目錄結(jié)構(gòu)可能在兩次運(yùn)行之間發(fā)生變化。每次任務(wù)開(kāi)始都做一次完整準(zhǔn)備能省掉很多半夜被報(bào)警吵醒的麻煩。4.2 給不同用戶(hù)隔離上傳空間文件上傳服務(wù)經(jīng)常要為用戶(hù)建獨(dú)立目錄結(jié)構(gòu)一般是uploads/用戶(hù)ID。這里有兩個(gè)隱蔽的坑用戶(hù) ID 可能包含攻擊性字符目錄名可能非常長(zhǎng)。如果直接把用戶(hù)輸入拼進(jìn)路徑再調(diào)用os.mkdir()就會(huì)帶來(lái)路徑穿越風(fēng)險(xiǎn)。我處理這類(lèi)需求時(shí)會(huì)在兩個(gè)層面做防護(hù)。第一層是限制目錄名只允許字母、數(shù)字、下劃線(xiàn)和中劃線(xiàn)其余字符一律拒絕或做哈希轉(zhuǎn)換。第二層是創(chuàng)建目錄前先做一次絕對(duì)路徑歸一化確認(rèn)最終路徑仍然以基礎(chǔ)目錄開(kāi)頭from pathlib import Path base_dir Path(uploads).resolve() user_dir (base_dir / safe_user_id).resolve() if not user_dir.is_relative_to(base_dir): raise ValueError(非法路徑) user_dir.mkdir(parentsTrue, exist_okTrue)is_relative_to這個(gè)判斷是必要的。假設(shè)用戶(hù) ID 被傳入../admin拼出來(lái)的路徑就跑到了上傳目錄外面再配合mkdir創(chuàng)建等于給了對(duì)方一個(gè)在服務(wù)器任意位置創(chuàng)建目錄的機(jī)會(huì)。先解析再校驗(yàn)最后創(chuàng)建順序不能亂。4.3 臨時(shí)目錄的創(chuàng)建與清理有時(shí)程序需要一個(gè)臨時(shí)目錄存放中間文件用完之后再整體刪除。很多人會(huì)想到自己寫(xiě)mkdir 完成后shutil.rmtree實(shí)際上標(biāo)準(zhǔn)庫(kù)已經(jīng)提供了更安全的封裝tempfile.TemporaryDirectory()import tempfile with tempfile.TemporaryDirectory() as tmp_dir: # 這里可以做任何文件操作 pass # 退出后目錄自動(dòng)清理但如果你需要臨時(shí)目錄在程序崩潰日志里留下痕跡不想被自動(dòng)清理也可以用樸素方案先建一個(gè)帶隨機(jī)后綴的目錄import os import tempfile base /tmp/myapp os.makedirs(base, exist_okTrue) tmp_dir os.path.join(base, next(tempfile._get_candidate_names())) os.mkdir(tmp_dir)這里能看出os.mkdir()單層語(yǔ)義的另一個(gè)價(jià)值當(dāng)你只創(chuàng)建一個(gè)出來(lái)時(shí)路徑結(jié)構(gòu)完全可預(yù)測(cè)清理邏輯只需要?jiǎng)h除自己創(chuàng)建的那一個(gè)目錄不會(huì)誤傷更上層的目錄樹(shù)。4.4 初始化時(shí)校驗(yàn)父目錄權(quán)限創(chuàng)建目錄失敗有一部分原因是父目錄不可寫(xiě)尤其項(xiàng)目部署在共享目錄或者只讀掛載盤(pán)上時(shí)。初始化階段把權(quán)限校驗(yàn)放在創(chuàng)建之前可以快速定位環(huán)境問(wèn)題import os parent data if os.path.exists(parent) and not os.access(parent, os.W_OK): raise PermissionError(f父目錄 {parent} 不可寫(xiě)請(qǐng)檢查目錄權(quán)限) os.makedirs(os.path.join(parent, temp), exist_okTrue)需要提醒的是os.access的結(jié)果只是粗略參考在復(fù)雜權(quán)限模型下不一定與真實(shí)寫(xiě)入結(jié)果一致它繞過(guò)了部分 ACL 細(xì)節(jié)。判斷權(quán)限最終還是要靠mkdir實(shí)際執(zhí)行時(shí)是否拋PermissionError。真正的工程做法是啟動(dòng)時(shí)主動(dòng)嘗試創(chuàng)建并寫(xiě)入一個(gè)探測(cè)文件成功才繼續(xù)后續(xù)流程而不是花大量時(shí)間推理權(quán)限矩陣。5. 排查清單與避坑實(shí)錄5.1 FileNotFoundError路徑層級(jí)沒(méi)補(bǔ)齊報(bào)錯(cuò)信息通常是FileNotFoundError: [Errno 2] No such file or directory: data/2025/04/01?？吹竭@個(gè)異常第一反應(yīng)不要糾結(jié)目標(biāo)目錄本身應(yīng)先檢查它的父目錄是否都存在。排查步驟可以按順序來(lái)打印目標(biāo)路徑的完整字符串用repr看有沒(méi)有隱藏的特殊字符。用os.path.dirname()拿到父目錄逐個(gè)判斷是否存在。確認(rèn)是否因?yàn)?和\混用導(dǎo)致路徑在某層解析失敗。如果父目錄確實(shí)不存在決定是用os.makedirs遞歸創(chuàng)建還是手動(dòng)逐層創(chuàng)建。我曾經(jīng)見(jiàn)過(guò)一種特別容易誤導(dǎo)的變體路徑中間某一部分是文件而不是目錄。比如目標(biāo)路徑是data/user/upload/2025其中data/user是一個(gè)正常目錄但upload是別人不小心創(chuàng)建的同名文件。此時(shí)FileNotFoundError信息不會(huì)直接說(shuō)“中間有文件”而是繼續(xù)報(bào)找不到排查時(shí)必須手動(dòng)檢查每一層。配合上面提到的自定義ensure_dir函數(shù)可以在正式寫(xiě)文件前就把這類(lèi)結(jié)構(gòu)性問(wèn)題暴露出來(lái)。5.2 FileExistsError重復(fù)運(yùn)行和并發(fā)創(chuàng)建FileExistsError: [Errno 17] File exists: output是另一種高頻異常。重復(fù)運(yùn)行定時(shí)任務(wù)、多個(gè) Worker 同時(shí)初始化、服務(wù)重啟后沒(méi)有清空歷史目錄都可能觸發(fā)。解決方式無(wú)非兩種創(chuàng)建前判斷或者創(chuàng)建時(shí)捕獲。前面我講過(guò) TOCTOU 問(wèn)題也就是“先判斷再創(chuàng)建”在并發(fā)下存在競(jìng)態(tài)窗口。所以并發(fā)場(chǎng)景一律推薦這樣寫(xiě)try: os.mkdir(dir_path) except FileExistsError: if not os.path.isdir(dir_path): raise這段代碼比單純pass更嚴(yán)謹(jǐn)如果已經(jīng)存在的是一個(gè)普通文件而不是目錄isdir返回 False此時(shí)把原異常拋出去不會(huì)讓后面的邏輯帶著錯(cuò)誤狀態(tài)繼續(xù)跑。我強(qiáng)烈建議團(tuán)隊(duì)里的目錄初始化代碼統(tǒng)一采用這個(gè)模式而不是到處寫(xiě)if not exists: mkdir。5.3 PermissionError權(quán)限、umask 和 Windows 細(xì)節(jié)PermissionError: [Errno 13] Permission denied出現(xiàn)時(shí)目錄邏輯本身往往是對(duì)的問(wèn)題出在運(yùn)行環(huán)境。常見(jiàn)的誘因包括進(jìn)程賬戶(hù)對(duì)父目錄沒(méi)有寫(xiě)權(quán)限、磁盤(pán)以只讀方式掛載、SELinux/AppArmor 限制了進(jìn)程的文件創(chuàng)建能力。在 Linux 下還要回頭檢查mode與umask的組合是否符合預(yù)期。我遇到過(guò)這么一件事某運(yùn)維同學(xué)在代碼里寫(xiě)os.mkdir(shared, mode0o777)自信地認(rèn)為所有人都能寫(xiě)入結(jié)果其他用戶(hù)依然報(bào)權(quán)限不足。查到最后發(fā)現(xiàn)系統(tǒng)的umask是0o0220o777被削成了0o755。當(dāng)時(shí)修數(shù)據(jù)靠chmod救場(chǎng)回頭把代碼改成先mkdir再os.chmod(shared, 0o777)才徹底解決問(wèn)題。Windows 下權(quán)限錯(cuò)誤通常和目錄所有權(quán)、共享文件夾的 NTFS 權(quán)限有關(guān)?？缙脚_(tái)項(xiàng)目里代碼不要過(guò)度依賴(lài)mode應(yīng)該把重點(diǎn)放在“啟動(dòng)時(shí)探測(cè)實(shí)際讀寫(xiě)能力”上提前發(fā)現(xiàn)問(wèn)題。5.4 目錄路徑解析相對(duì)路徑、絕對(duì)路徑和符號(hào)鏈接一個(gè)隱藏得很深的坑是符號(hào)鏈接。假設(shè)路徑data是一個(gè)指向/tmp/real_data的符號(hào)鏈接你在data下創(chuàng)建新目錄時(shí)文件實(shí)際上落在了/tmp/real_data里從應(yīng)用視角看沒(méi)問(wèn)題從系統(tǒng)管理視角看可能出乎意料。處理多級(jí)路徑時(shí)我建議在關(guān)鍵位置調(diào)用一次Path.resolve()把符號(hào)鏈接解析成真實(shí)路徑。這樣寫(xiě)入日志、排查問(wèn)題時(shí)看到的路徑路徑才是文件真正所在的位置。同時(shí)也要注意resolve()之后原先的相對(duì)路徑在重啟服務(wù)后可能因?yàn)楫?dāng)前工作目錄變化而不同所以生產(chǎn)環(huán)境里盡量使用絕對(duì)路徑做根目錄。5.5 用 debug 方式快速確認(rèn)路徑內(nèi)容排查目錄創(chuàng)建問(wèn)題時(shí)最直接的輔助工具就是把路徑打印出來(lái)看。但很多人打印用的是print(path)某些不可見(jiàn)字符比如尾部空格、換行符在普通輸出里完全顯示不出來(lái)。我習(xí)慣用print(repr(str(path)))讓字符串帶上引號(hào)特殊字符一目了然。另外一個(gè)實(shí)用技巧是在創(chuàng)建目錄失敗時(shí)把父目錄的內(nèi)容列出來(lái)確認(rèn)是否存在同名文件或命名相近的混亂目錄import os backup_parent os.path.dirname(path) print(os.listdir(backup_parent))這一招在“目錄名只差一個(gè)字母”“存在隱藏空格”的場(chǎng)景下非常高效。與其對(duì)著異常信息猜不如直接看父目錄里到底有什么往往一眼就能定位問(wèn)題。6. 最后分享一點(diǎn)個(gè)人實(shí)操體會(huì)我從這些目錄創(chuàng)建的坑里爬出來(lái)后養(yǎng)成了一個(gè)很簡(jiǎn)單的習(xí)慣凡是寫(xiě)目錄初始化的代碼第一反應(yīng)直接用os.makedirs(path, exist_okTrue)或者Path.mkdir(parentsTrue, exist_okTrue)不再糾結(jié)是否應(yīng)該用os.mkdir()。這不是說(shuō)os.mkdir()沒(méi)用而是多數(shù)業(yè)務(wù)場(chǎng)景根本不需要單層創(chuàng)建的限制。真正需要單層邏輯的地方比如嚴(yán)格避免誤建多級(jí)路徑時(shí)我會(huì)寫(xiě)得很明確在異常分支里補(bǔ)上isdir校驗(yàn)確保路徑狀態(tài)的準(zhǔn)確性。還有一個(gè)特別值得分享的小技巧不管用哪種方式創(chuàng)建目錄建議在服務(wù)正式上線(xiàn)前把目錄初始化單獨(dú)跑一遍并把每個(gè)關(guān)鍵路徑的最終狀態(tài)輸出到日志里。這一步看著簡(jiǎn)單卻能讓部署環(huán)境里隱藏的路徑格式問(wèn)題、權(quán)限問(wèn)題早于業(yè)務(wù)高峰暴露而不是等到凌晨定時(shí)任務(wù)開(kāi)始跑的時(shí)候才在報(bào)警群里手忙腳亂。目錄創(chuàng)建這行代碼雖然短該有的工程講究一點(diǎn)都不少。把os.mkdir()的單層行為吃透遇到多級(jí)路徑知道該用哪把工具再配合一套統(tǒng)一的封裝函數(shù)這套基本功會(huì)讓文件上傳、日志歸檔、數(shù)據(jù)同步這類(lèi)功能穩(wěn)很多。