-
推荐采用tests/顶层目录结构，镜像源码层级，如src/utils/helpers.py对应tests/utils/test_helpers.py；conftest.py按作用域分层放置，tests/下建议保留空__init__.py确保导入安全。
-
异步死锁是协程await永久不释放的锁时静默挂起，主因是多协程交叉获取锁顺序不一致导致循环等待；须按全局统一顺序加锁、缩小临界区、禁用手动acquire/release、用asyncwith确保释放。
-
最有效方式是使用参数化查询，原理是分离SQL结构与数据，通过预处理语句绑定参数避免输入被解析为代码；拼接字符串（如f-string）会导致注入，因输入直接进入SQL语法；占位符写法依驱动而异，但机制统一；表名、字段名等SQL结构部分需白名单校验。
-
调用高德/百度地图API获取POI需合法Key且受配额限制，返回坐标为加密系（GCJ-02或BD-09），跨平台使用须经可靠转换（如coordtransform库），硬爬网页无效且违规。
-
Python命令调用PATH中第一个python可执行文件；which与--version不一致说明该路径是wrapper或symlink；macOSHomebrew默认只放python3，Linux用update-alternatives，Windows注册表影响双击但命令行仍由PATH决定；安全切换推荐alias、临时PATH或pyenvlocal；shebang用#!/usr/bin/envpython同理查PATH，不支持python3.10等带版本名写法；pip必须与python配对，应优先用p
-
本文详解Django模型中ManyToManyField的正确使用方式，重点解决新手在创建预约记录时无法将医生关联到Appointment实例的问题，涵盖模型定义、视图逻辑、数据绑定及常见错误规避。本文详解Django模型中`ManyToManyField`的正确使用方式，重点解决新手在创建预约记录时无法将医生关联到Appointment实例的问题，涵盖模型定义、视图逻辑、数据绑定及常见错误规避。在Django开发中，ManyT
-
FastAPI实现“登录后才显示某些字段”的核心是动态响应模型，可通过三种方式：一用Field(exclude=True)配合model_dump条件序列化；二定义UserPublic与UserPrivate两个模型并用Union响应类型；三用依赖注入+模型工厂函数按权限返回不同实例。
-
str.isdigit()仅判断整个字符串是否全为ASCII数字字符，不能提取或分割数字；实用数字提取应使用re.findall(r'\d+')获取连续整数块。
-
Requests请求超时必须显式设置，否则默认无限等待导致卡死；推荐用元组timeout=(connect,read)如(3,10)，并结合urllib3.Retry实现带退避的可控重试。
-
本文详解如何在发布PyPI包时正确打包并安全读取内置JSON资源文件，解决因FileNotFoundError导致的运行时数据加载失败问题。
-
re.Match.group(n)访问不存在分组时抛IndexError，因组编号超出正则定义范围；安全方式包括：用groupdict().get()取命名组、try/except捕获异常，而非依赖len(groups())或groupindex预判。
-
subprocess.check_output默认吞掉stderr且不暴露，仅当退出码非零才抛异常；需改用subprocess.run(...,capture_output=True,check=True)分别获取stdout和stderr。
-
np.sum()结果与预期不相等是因浮点数二进制表示固有误差，累积导致微小偏差；应使用np.allclose()等容差比较而非==，关键场景可改用Decimal或Kahan求和。
-
pip升级后报错主因是路径错位、工具链脱节与缓存污染；应优先验证python-mpip--version，再手动将用户级Scripts/bin路径加入PATH，并同步升级setuptools、wheel与pip。
-
TensorFlow1.x需禁用急切执行并传入完整图：tf.compat.v1.disable_eager_execution()后定义占位符、变量等节点，再用tf.summary.FileWriter("./logs",graph=tf.get_default_graph()).close()导出；否则TensorBoard显示“Nographdefinition”。
