-
opencc-python安装失败主因是PyPI包不包含libopencc.so等系统依赖，需先装libopencc-dev（Linux）、opencc（macOS）或改用opencc-python（Windows）；编码乱码须显式指定encoding='utf-8'；config选错致转换失准，应按地区选用s2tw等配置；大文件须流式逐行处理防内存溢出。
-
CSV中文乱码主因是文件编码与pandas读取encoding不一致，Windows记事本默认gbk而pandas默认utf-8；推荐用编辑器查实际编码或chardet探测，优先试'gbk'或'utf-8-sig'。
-
comtypes调用WordCOM失败主因是环境未配好：需安装与Python位数一致的桌面版Word，手动首次运行完成COM注册，并设Visible=False和DisplayAlerts=0避免弹窗；SaveAs导出PDF须用FileFormat=17，路径用原始字符串，且必须调用doc.Close()和word.Quit()释放进程。
-
日志清洗解析的核心是将非结构化日志转为结构化数据，关键在于识别格式规律、分步正则提取、异常清洗及结构化输出分析。
-
本文详解如何在PySpark中安全、高效地展开多个同结构嵌套数组字段，重点规避explode()链式调用引发的笛卡尔积式行数爆炸，显著提升性能并防止OOM（如错误代码52），推荐使用arrays_zip+explode组合替代多重独立explode。
-
推荐采用分层结构：1.指标采集层按协议解耦为独立模块；2.配置驱动使用YAML管理目标、阈值与调度；3.日报生成层用pandas+Jinja2渲染带状态标记的HTML；4.运行层支持命令行参数、结构化日志与错误通知。
-
ConnectionResetError通常因对端关闭连接导致，需通过异常捕获、重试机制和连接复用优化处理。
-
Flask-Migrate初始化失败主因是db实例未正确初始化或未被发现：需在模块顶层声明db=SQLAlchemy()，并在create_app()中调用db.init_app(app)；FLASK_APP须指向含db和模型的可导入路径，且models必须被显式导入。
-
应优先使用model.state_dict()获取完整权重（含参数和缓冲区），通过键名前缀匹配（如k.startswith("encoder.layer.11.")）精确提取子模块，避免in操作误匹配，注意前缀末尾带点、区分大小写，并校验键名一致性。
-
Python私有变量并非真正私有，仅通过命名约定（如_var）和名称修饰（如__var→_ClassName__var）实现弱约束，不提供强制访问控制，仅防误用。
-
NearestNeighbors默认使用欧氏距离，底层调用sklearn.metrics.pairwise.euclidean_distances，对每对样本计算平方差和的平方根；未归一化时量纲差异会导致大数值特征主导距离结果。
-
docker-compose.yml中depends_on仅控制启动顺序而非服务就绪，需配合healthcheck与service_healthy或应用层重试；依赖应构建时安装；源码用volumes挂载但排除venv；环境变量需显式透传或容器内加载；gunicornworker数应据内存限制调整；日志须输出到stdout/stderr。
-
使用try语句写入文件时内容未落盘，通常因文件未显式关闭导致缓冲区数据丢失；正确做法是确保调用f.close()，或更优地采用with语句自动管理资源。
-
异步编程解决多任务处理时不阻塞程序的问题，核心是协程与事件循环。用async定义协程，await暂停执行并交出控制权，asyncio.run启动事件循环，asyncio.gather并发运行多个协程，适用于IO密集型任务如网络请求、文件读写，不适合CPU密集型场景。
-
GBK文件需显式指定encoding='gbk'读取，否则因Python默认UTF-8解码而报UnicodeDecodeError；不确定时用'gb18030'更鲁棒，禁用errors='ignore'；批量处理应先用charset-normalizer检测编码，再流式转存为UTF-8。
