CSDN 完整教程系列《從小白到 AI 大模型開發(fā)工程師的進階之路》 技術(shù)點AI-0126 模塊與包 主人公小藍傘本文是第 38 期圍繞【import、from、模塊搜索路徑、包結(jié)構(gòu)和init】展開。示例用于復(fù)現(xiàn)實驗標注【建議驗證】的部分需要按讀者自己的 Windows、Python 版本和網(wǎng)絡(luò)條件執(zhí)行。一、問題背景與適用場景將文本清洗函數(shù)與命令行入口拆分到 appkit 包從項目根目錄啟動。 本期要把概念落成一個可觀察、可回滾的小實踐。二、先給結(jié)論模塊拆職責包做目錄組織從項目根目錄用 python -m 運行入口避免循環(huán)導入和依賴當前目錄的隱式行為。 本期最小產(chǎn)出可安裝的練習包。三、前置準備Windows 10/11建議 Python 3.11 或項目采用的兼容版本。練習目錄D:\ai-learning\issue-38涉及文件、依賴或配置時先備份。不要提交 Token、密碼和個人路徑未執(zhí)行命令不得寫成實測結(jié)果。四、最小可復(fù)現(xiàn)實踐在練習目錄保存并執(zhí)行分別創(chuàng)建以下文件代碼塊中的注釋就是文件路徑# appkit/__init__.py from .text import normalize ? __all__ [normalize]# appkit/text.py def normalize(text): return .join(text.split()).lower()# appkit/main.py from appkit.text import normalize ? if __name__ __main__: print(normalize( Hello Python ))# pyproject.toml [build-system] requires [setuptools68] build-backend setuptools.build_meta ? [project] name appkit-demo version 0.1.0 description Python package practice在項目根目錄執(zhí)行python -m pip install -e .再執(zhí)行python -m appkit.main。預(yù)期結(jié)果安裝命令完成后模塊入口輸出 hello python修改源碼后可被當前虛擬環(huán)境直接導入說明這是可安裝的練習包。五、關(guān)鍵原理與工程判斷1. 先定義輸入和成功判據(jù)模塊拆職責包做目錄組織從項目根目錄用 python -m 運行入口避免循環(huán)導入和依賴當前目錄的隱式行為。2. 保留狀態(tài)和失敗原因把輸入、輸出、版本、目錄和完整錯誤記入 README 或日志便于定位而不是只寫【失敗】。3. 小步執(zhí)行與回滾先跑最小樣例再一次改一個變量危險操作先 dry-run、備份或 Git 提交。六、常見問題與避坑直接運行包內(nèi)文件導致相對導入失敗從項目根目錄使用 python -m 包.模塊。文件名遮蔽標準庫或第三方包避免使用 json.py、requests.py 等名稱。模塊頂層執(zhí)行副作用或相互導入把入口放進 main 并拆清依賴方向。七、驗證清單正常、邊界、失敗三類輸入均有驗證。重新打開終端或進程后復(fù)驗排除緩存和當前會話影響。產(chǎn)物能再次讀取、運行或恢復(fù)未實測部分標記【建議驗證】。八、面試題本期技術(shù)點解決什么問題解決輸入、狀態(tài)或失敗邊界的可控性。為什么先做最小實踐降低變量數(shù)量區(qū)分語法、環(huán)境和業(yè)務(wù)問題。出現(xiàn)錯誤先做什么保存完整錯誤確認版本、目錄、權(quán)限和輸入。如何判斷真正生效重啟相關(guān)進程后用獨立命令和功能測試復(fù)核。什么時候不能照搬示例系統(tǒng)、版本、權(quán)限或輸入契約不同就要先調(diào)整并閱讀官方文檔。九、本期小結(jié)與下一期本期完成 可安裝的練習包把正確路徑和失敗路徑都變成可驗證動作。下一期繼續(xù)學習資料庫中的下一個技術(shù)點。點個關(guān)注不迷路跟著小藍傘把 Python 基礎(chǔ)變成工程能力?？煽康某绦蛞惨芙忉屖?。官方資料6. Modules — Python 3.14.7 documentation十、記錄與回滾建議記錄時間、解釋器版本、執(zhí)行目錄、關(guān)鍵輸出和失敗原因出現(xiàn)異常先停止批量操作保留現(xiàn)場后恢復(fù)備份或回退 Git。