-
应使用Python内置csv模块配合newline=''和quoting=csv.QUOTE_MINIMAL，或预处理修复引号嵌套，或改用pandas.read_csv并设置quoting=csv.QUOTE_ALL与lineterminator参数。
-
根本原因是ftplib默认使用主动模式（PORT），而现代网络环境普遍只支持被动模式（PASV），需手动调用ftp.set_pasv(True)；上传失败还常因未处理异常类型、未校验文件完整性、未用临时文件名+重命名原子操作、误用storlines替代storbinary，以及大文件未分块传输所致。
-
asyncio.wait不控制任务执行顺序，仅并发等待可等待对象完成；需顺序执行时应直接await，有依赖的并发任务应封装为内部串行的协程单元。
-
观察者模式是“一对多”依赖关系，被观察者状态改变时自动通知所有观察者；Python中可用函数引用和列表实现基础订阅系统，weakref可避免内存泄漏，生产环境推荐blinker等轻量库。
-
ScannerError是YAML词法扫描阶段的语法错误，源于冒号缺失、Tab缩进、全角符号、引号不匹配等字符级违规，需用yaml.scan()定位line/column并检查空白符与编码。
-
.pre-commit-config.yaml不生效的主因是未运行pre-commitinstall（而非install-hooks）导致钩子未写入.git/hooks/pre-commit；新增修复型钩子默认只检查暂存文件，需pre-commitrun--all-files手动触发；default_stages缺失或language_version未显式指定也会导致跳过。
-
Celery任务重试必须显式传countdown参数，否则默认countdown=0导致瞬时重试；指数退避需手动计算countdown值（如2**self.request.retries），并用raiseself.retry(countdown=countdown,exc=exc)触发，不可仅调用self.retry()。
-
应使用mutagen提前解析音频文件获取总时长，因pygame.mixer.Sound.get_length()不稳定且不支持MP3，pygame.mixer.music无直接时长接口；mutagen支持MP3/WAV/OGG，一行代码返回秒级精度浮点数。
-
Python命名空间是名字到对象的映射，分为局部、全局和内置三类，按LEGB规则查找；作用域决定可见性，if/for不建新命名空间，class创建独立命名空间，可用locals()、globals()等查看。
-
Python不支持InterfaceOne&InterfaceTwo这样的交集类型语法，但可通过typing.Protocol定义结构化协议，并通过多重继承协议创建“组合协议”，从而精准表达“必须同时满足多个接口”的类型约束。
-
面向失败的设计需预判故障点并确保系统可恢复，而非仅用try/except掩盖错误；每个except必须记录日志、告警或降级，区分I/O异常类型，HTTP失败时优先缓存或切备用接口，非法输入应抛具体异常而非返回None，测试须覆盖失败路径。
-
list.index()找不到元素时抛ValueError而非返回-1或None；支持start/stop参数限定搜索范围但返回原列表绝对索引；仅返回首个匹配索引，查全部需用enumerate；行为与str.find()不同，不可混用。
-
ROC曲线画不出需确认输入为正类概率或决策函数值；多模型ROC需复用ax参数叠加绘制；AUC值与曲线不匹配常因混淆AP与AUC或未正确处理多分类；保存高清图应调用tight_layout()于legend后并设bbox_inches='tight'。
-
防重表必须用业务唯一ID作主键或唯一索引，如order_no、trade_no或message_id；禁用自增ID；需与业务操作同事务；用INSERTIGNORE/ONCONFLICT原子写入；定期清理过期数据。
-
Flask的request在后台线程中不可用，因其依赖线程局部的请求上下文；需手动提取数据传入子线程，或使用copy_current_request_context；app_context适用于无请求场景，request_context才支持request/g/session。
