-
json.dumps()默认不支持set/frozenset，需通过default参数或自定义JSONEncoder处理；default最轻量，但需注意无序性、无限循环及嵌套未处理问题。
-
tqdm无法自动监控文件写入进度，因其仅依赖主动调用update()或可预估长度的迭代器；文件写入是无状态流式操作，无内置字节反馈机制，需手动分块写入并调用update()汇报进度。
-
asyncio.Condition()必须显式传入asyncio.Lock实例，否则报错；wait()需在持锁时调用，会自动释放并重获锁；notify无需持锁但建议在锁内调用以保证原子性；不可用threading.Condition替代，因其阻塞事件循环。
-
Django默认save()无并发控制，易导致后提交者覆盖前修改；需用乐观锁（版本号字段+条件更新）或谨慎使用select_for_update()悲观锁，并配合前端传回版本号校验。
-
dataclass 里的 list、dict、set 不能直接当默认值：当前 Python 会把常见的不可哈希默认值拦成 ValueError。应使用 field(default_factory=list) 在每次创建实例时生成新列表；当默认值来自配置或需要延迟构造时，也要分清工厂函数、浅拷贝和 None 的语义。
-
pytest-html默认不显示docstring，需确保函数首行为有效文档字符串并升级插件至≥3.2.0，配合--html和-v参数启用描述渲染。
-
Flask中Model指用SQLAlchemy等ORM定义的实体类及数据逻辑，应独立于视图和HTTP上下文，集中于models/目录，封装字段、查询与业务校验。
-
在Gekko优化中，当条件判断基于固定常量（如duration-5）而非决策变量时，不应使用if2或if3；直接分段计算并求和更准确、高效，且避免引入不必要的非线性或不可导点。在Gekko优化中，当条件判断基于**固定常量**（如`duration-5`）而非决策变量时，不应使用`if2`或`if3`；直接分段计算并求和更准确、高效，且避免引入不必要的非线性或不可导点。Gekko的if2和if3函数专为混合整数非线性规划（
-
应强制使用预编译wheel：执行pipinstall--only-binary=grpcio-ihttps://pypi.tuna.tsinghua.edu.cn/simplegrpcio，避免本地编译；若失败则手动下载匹配平台标签的.whl文件离线安装。
-
直接用json.dumps或简单循环无法真正展平嵌套字典，因其不处理list中元素、不区分数据类型、键名拼接无规则；需递归遍历dict和list，为每个路径生成唯一键名（如a.b.0.c）。
-
isnumeric()方法用于判断字符串是否全由数字类字符组成，返回布尔值。它支持阿拉伯数字、汉字数字、罗马数字及Unicode分数等，但不识别小数点和负号。例如"123"、"一三五"、"ⅢⅤⅩ"、"½"均返回True，而"1.5"、"-3"、"12a"和空字符串返回False。相比isdigit()和isdecimal()，isnumeric()范围最广，涵盖更多Unicode数字形式。实际中常用于多语言环境下的数据验证，但需注意其无法识别浮点数和负数，应结合try-except处理此类情况。
-
TensorFlow/Keras模型的predict()方法要求输入为张量或NumPy数组，且必须包含批处理维度；直接传入Python列表（如[10.0]）会触发“Unrecognizeddatatype”错误。TensorFlow/Keras模型的`predict()`方法要求输入为张量或NumPy数组，且必须包含批处理维度；直接传入Python列表（如`[10.0]`）会触发“Unrecognizeddataty
-
tkinter真全屏需用root.attributes("-fullscreen",True)，它由系统接管并隐藏任务栏/Dock；退出时须手动恢复geometry和resizable，macOS还需Tk8.6.12+及辅助功能权限。
-
aiohttp固定代理易被封禁主因是连接复用导致指纹一致及共享IP黑历史；需每次请求动态选验代理、禁用连接池、随机请求头，并构建多源自愈代理池。
-
importlib.util.find_spec("requests")是最轻量、无副作用的模块存在性检测方式，返回ModuleSpec对象或None，但不保证后续import一定成功。
