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