Python脚本通用化需参数化设计：用argparse管理命令行参数，配置外置JSON/YAML并支持覆盖，输入输出抽象为接口，强化错误提示与日志。
Python脚本要真正用得起来，关键不是写完就跑一次，而是能灵活适配不同场景——靠硬编码改来改去太低效，参数化才是通用化的起点。
用 argparse 统一管理命令行参数
别再用 sys.argv 自己切字符串了。argparse 不仅自动处理 --help、类型校验、默认值，还能让脚本一眼看懂怎么用。
- 必需参数用 required=True，可选参数加 default 或 const
- 路径类参数建议用 type=Path（配合 pathlib）或自定义检查函数，提前拦截非法路径
- 多个相似选项（如输入/输出格式）可用 choices=['csv', 'json', 'xlsx'] 限定取值范围
配置外置：支持 JSON/YAML + 命令行覆盖
把固定但易变的设置（如 API 地址、超时、重试次数）抽到配置文件里，运行时优先用命令行参数覆盖，兼顾灵活性与可维护性。
- 用 configparser（INI）、json.load 或 yaml.safe_load 读配置
- argparse 的 add_argument(..., action='store_true') 适合开关类配置（如 --dry-run）
- 示例逻辑：先加载 config.yaml，再用 parse_args() 结果更新字典，最后传给主函数
输入输出抽象成接口，不绑定具体格式
脚本核心逻辑不该关心数据从哪来、到哪去。用统一的读/写函数封装细节，后续增删 Excel、数据库、API 等支持只需改一层。
python-flask-vue-creator
下载
创建 Flask + Vue.js 全栈项目，采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发：创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词：新建项目、创建项目、搭建项目、Flask项目、Vue项目。
立即学习“Python免费学习笔记（深入）”；
- 定义 load_data(source: str) → pd.DataFrame 和 save_data(df, target: str)
- source/target 可是文件路径（自动识别后缀）、URL、甚至 "postgres://..." 连接串
- 内部用 dispatch 分发：".csv"→pandas.read_csv，".parquet"→read_parquet，URL→requests.get
错误处理与日志要“说得清、退得稳”
参数错、路径不存在、网络超时……这些不是异常，是预期中的分支。用清晰提示代替 traceback，让用户知道该改什么、而不是猜哪里错了。
- argparse 自带参数校验失败提示；自定义检查（如文件是否存在）用 parser.error("xxx 不存在")
- 关键步骤加 logging.info()，失败时 logging.error() 并 sys.exit(1)
- 避免 except Exception: pass —— 至少记录原始异常，或 re-raise 带上下文
参数化不是加几个 sys.argv 就算完成，而是围绕“人怎么用”重新组织脚本结构。从命令行入口开始分层，把变的和不变的切开，通用化就自然落地了。
