用途:这是一套 Python 最佳实践规则集,优先级为 P1(HIGH),用于指导编写可维护的 Python 代码,尤其适合重构 Python 服务、辅助函数等场景。
主要能力与规则:优先使用小而专注的函数,而非冗长的有状态过程;把解析、格式化、传输和持久化拆分为独立辅助函数;对无效或终止状态尽早返回(卫语句);通过参数传入协作者,不要用全局变量或导入期单例隐藏依赖;命名保持字面化且贴合领域。
配方:将编排与转换分离;把重复的结构清理提取为一个辅助函数;把副作用留在边缘,把纯决策放在中间;测试中尽量使用假对象(fakes),而不是打补丁深入到内部调用链。
反模式:不要“上帝函数”,把报表构建器和工作流循环拆成可测试的片段;不要“布尔汤”,用命名的决策辅助函数代替内联堆叠的标志;不要隐藏重试,把重试策略暴露在调用点附近;不要在共享运行时代码中打印调试,改用结构化日志或测试断言。
限制:资料未提供具体安装命令、代码示例、平台或收费信息,暂未提供。