-
asyncio.Condition()必须显式传入asyncio.Lock实例，否则报错；wait()需在持锁时调用，会自动释放并重获锁；notify无需持锁但建议在锁内调用以保证原子性；不可用threading.Condition替代，因其阻塞事件循环。
-
用Path.samefile(other_path)最可靠，它通过inode（Unix/Linux/macOS）或卷序列号+文件索引（Windows）判断是否为同一文件实体，自动解析符号链接，要求路径存在。
-
Python正则表达式关键在于理解模式与文本的交互关系，需明确“想匹配什么”和“文本里实际有什么”；模式由普通字符和元字符组成，推荐用原始字符串书写；常用元字符如\d、\w、.、^、$、*、+、?等需结合上下文理解；分组()可捕获内容，(?P<name>...)支持命名提取，(?:...)为非捕获组；注意贪婪/懒惰匹配、函数差异（search/findall/finditer）、中文编码及预编译优化。
-
能，但仅对同步视图有效；async视图须用asyncio.Semaphore；多worker下需分布式限流如Redis或nginx。
-
Django默认save()无并发控制，易导致后提交者覆盖前修改；需用乐观锁（版本号字段+条件更新）或谨慎使用select_for_update()悲观锁，并配合前端传回版本号校验。
-
cosine_similarity对超长文本报错或不准，因其只处理向量；超长文本直接向量化易致内存爆炸、维度失控或语义失真；应先分句、用sentence-transformers编码、再均值池化并归一化后计算相似度。
-
主题配置应存最小可行字段集：window_width、window_height、window_x、window_y、bg_color、font_family、font_size、button_bg、button_fg、use_dark_mode；用UTF-8编码+绝对路径保存JSON；加载时需三层异常防护并类型校验；应用时优先ttk.Style统一设置，辅以组件类型分组config。
-
Python3.12正式废弃unittest.TestCase.runTest方法，调用时触发DeprecationWarning:TestCase.runTest()isdeprecated，未来版本将移除；旧式动态测试需迁移至pytest等现代框架。
-
Loguru让Python日志更简单，无需复杂配置即可使用。导入logger后可直接输出调试、信息、警告、错误日志，默认控制台显示info及以上级别。通过logger.add()可将日志写入文件，支持按天轮转、保留策略和级别过滤。支持自定义格式，包含时间、级别、文件、行号等信息，并能用logger.exception()捕获异常堆栈。可移除默认handler并重新配置输出目标，适合全局使用，各模块共享同一logger实例，简化项目日志管理。
-
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文件离线安装。
-
NumPy广播按从右向左逐轴比对形状，每轴需相等或为1，否则报错；补前导1后兼容即生成新形状，但不复制数据，逻辑展开可能引发内存爆炸。
-
直接用json.dumps或简单循环无法真正展平嵌套字典，因其不处理list中元素、不区分数据类型、键名拼接无规则；需递归遍历dict和list，为每个路径生成唯一键名（如a.b.0.c）。
