-
Python3.12下pipinstallnumpy失败的典型表现是：卡在metadata下载、报ReadTimeoutError，或安装后导入时抛出incompatiblearchitecture错误；根本原因是官方PyPI缺乏完整预编译wheel、pip/setuptools版本过低（需≥23.3和≥67.0.0）及网络问题，应升级工具链后用清华镜像源指定numpy==2.0.1手动安装。
-
StreamingResponse默认启用chunkedtransferencoding，前提是不设Content-Length且ASGI服务器（如Uvicorn）支持；需注意Nginx缓冲、生成器yield频率与大小、前端读取方式及超时配置。
-
必须同时实现enter和exit方法，因with语句严格检查二者缺一不可；仅定义enter会报AttributeError:exit__；__exit须接收三个异常参数并按需返回True/False控制异常传播；@contextmanager要求单次yield且需try/finally保证清理。
-
优先分析接口抓取数据，若不可行则用Selenium模拟滚动加载。通过开发者工具定位XHR请求，用requests直接获取JSON；或用Selenium控制浏览器滚动到底部，等待新内容加载后解析HTML提取信息并保存。
-
Python日志处理核心是可靠可维护：用TimedRotatingFileHandler按日期轮转并设delay=True防空文件，多进程用ConcurrentLogHandler或QueueHandler+QueueListener，Formatter注入结构化字段，LoggerAdapter动态加业务ID，分级控制支持运行时调整。
-
在DjangoCRM系统中，直接删除被估计单、服务报告或发票引用的库存项会导致外键关联断裂，引发页面加载失败；正确做法是通过on_delete参数配置外键行为（如SET_NULL），使历史记录保留完整性，同时逻辑上“下架”该库存项。在DjangoCRM系统中，直接删除被估计单、服务报告或发票引用的库存项会导致外键关联断裂，引发页面加载失败；正确做法是通过`on_delete`参数配置外键行为（如`SET_NULL`），使历史记录保留
-
Python爬虫需用prometheus_client的start_http_server启动HTTP服务暴露/metrics端点，不可仅依赖框架路由；须在独立线程运行、避免阻塞主逻辑，指标命名用snake_case并加业务前缀，更新须覆盖所有状态分支。
-
PySide6安装失败或导入报错需确保Python与PySide6版本及架构匹配，优先用pipinstallPySide6；界面卡死须将耗时操作移至QThread或QThreadPool；打包后资源路径应基于sys._MEIPASS动态构建；高DPI适配需手动设置缩放因子与字体策略。
-
Python3的/统一为真除法且结果恒为float，彻底放弃Python2中依赖操作数类型的隐式整除语义，强制数值计算显式、可预测；//向负无穷取整，跨版本语义一致但类型仍受操作数影响。
-
多进程异常处理需通过IPC机制传递异常信息，因进程隔离导致异常无法自动冒泡。常用方法包括：子进程中捕获异常并通过Queue或Pipe发送给父进程；使用multiprocessing.Pool的AsyncResult.get()在父进程重新抛出异常；辅以日志记录便于排查。关键在于主动传递异常详情，避免沉默失败，并注意pickle序列化、超时设置和资源清理等问题。
-
prune.l1_unstructured仅添加掩码而不删参数，需调用prune.remove()才能永久移除零值参数并减小模型体积；结构化剪枝应使用prune.ln_structured按通道裁剪，保存前必须remove以避免加载错误。
-
weakref.proxy不能自定义行为，因其为C层实现，绕过Python属性访问钩子；可行方案是用weakref.ref+自定义代理类，在getattr等方法中手动解引用并插入逻辑。
-
默认aiohttp.TCPConnector频繁新建连接，根本原因是limit过小、limit_per_host为0或keepalive_timeout过短；需显式配置limit、limit_per_host、keepalive_timeout等参数并确保session复用和生命周期管理正确。
-
np.dot执行矩阵乘法而非点乘，二维时要求左矩阵列数等于右矩阵行数；逐元素相乘用multiply或*；叉乘仅适用于三维向量，用cross函数。
-
MiniBatchKMeans比KMeans更适合海量数据，因其每次仅用小批量样本（默认1024）更新中心，内存稳定、收敛快；虽为近似解，但对特征预处理等任务足够有效。
