一套可直接執行的 Python 教學範例專案。每個章節內含多個獨立腳本，皆可直接以 Python 執行，並在程式中附上關鍵註解，方便學習與複習。
01-basics/：基礎語法（輸出、變數、型別、輸入等）02-data-structures/：常用資料結構（tuple、set、dict、comprehensions）03-functions/：函式、參數（*args/**kwargs）、lambda05-advanced/：進階主題（dataclasses、context manager）06-modules/：模組與套件（import、封裝、-m執行範例）07-file-io/：檔案讀寫（文字檔、JSON）08-exceptions/：例外處理與自訂例外09-decorators/：裝飾器（基本與參數化）10-generators/：產生器（yield、itertools 工具）
（各檔案均含中文註解與示例輸出說明）
- 建議使用 Python 3.10+
- 選擇任一範例檔直接執行，例如：
# 01 基礎
python 01-basics/01_hello_world.py
# 02 資料結構
python 02-data-structures/04_dicts.py
# 03 函式與參數
python 03-functions/02_args_kwargs.py
# 05 進階：資料類別
python 05-advanced/01_dataclasses.py
# 06 模組與套件（用 -m 執行 package 範例）
python -m 06-modules.02_package_demo.main
# 07 檔案 I/O
python 07-file-io/01_text_files.py
python 07-file-io/02_json_files.py
# 08 例外處理
python 08-exceptions/01_try_except.py
# 09 裝飾器
python 09-decorators/01_simple_decorator.py
# 10 產生器
python 10-generators/01_generator_functions.py- Windows 執行
python需確認 PATH 已設定；若以py為啟動器，可改用py script.py。 - 若有相依套件需求，請先建立 venv 並安裝對應套件（目前多為標準庫示例，少數章節才需額外套件）。
git add .
git commit -m "docs: restore rich README with runnable examples"
git push origin main若遠端已有初始 README 導致衝突，請先同步後再推送：
git fetch --prune origin
git pull --rebase origin main
git push origin main