-
Sphinx是本地文档构建工具，ReadtheDocs是托管平台；常见问题包括PATH未配置导致命令找不到、插件版本不兼容、readthedocs.yml路径或缩进错误、RTD版本未激活及构建日志被忽略。
-
py-spy报Permissiondenied的根本原因是需SYS_PTRACE权限读取进程内存，Linux默认禁止非特权进程使用ptrace；解决方法包括：本地用sudo运行、Docker加--cap-add=SYS_PTRACE、K8s在securityContext中声明该能力，并确保/proc只读挂载。
-
最稳方式是用Paramiko的SFTP校验文件大小+编码探测+字段对齐+文件锁+时间/大小双重缺失判断。关键在传后校验、编码适配、并发控制、缺失告警，而非仅传输本身。
-
axis=0插入行，axis=1插入列；axis指被操作的维度，与插入位置无关，只决定新增数据方向。
-
np.array_split比np.split更适合分块大数组，因其能自动处理余数、不报错；它按axis=0默认行拆，需显式指定axis=1才列拆；返回子数组长度最多相差1，非严格均等。
-
np.meshgrid生成经纬网格时，Y对应纬度、X对应经度，shape为(len(lat),len(lon))，需注意坐标顺序、单调性、跨日界线处理、内存优化及xarray坐标定义规范。
-
直接调用父类名会破坏菱形继承的初始化顺序，因强行跳过MRO导致A.__init__重复执行、C.__init__被跳过及super()链中断；应统一用super()配合**kwargs透传参数，并验证D.__mro__确保顺序正确。
-
WeakValueDictionary能防止内存泄漏，因为它对值使用弱引用，值被GC回收后自动删除对应键值对；但键仍为强引用，且值必须支持弱引用（如自定义类实例），初始化需逐个赋值而非批量传入。
-
实例方法必须带self且只能通过实例调用；@classmethod必须带cls，类和实例均可调用；@staticmethod无隐式参数，适用于不依赖实例或类的纯函数。
-
PyTorch+VGG19实现风格迁移可行，但必须严格对齐Gatys论文：内容损失用relu4_2层特征，风格损失用relu1_1至relu5_1多层Gram矩阵（需手动实现并除以C×H×W归一化），且content_weight与style_weight需按特征量级合理缩放。
-
在Python3.9中，将re.compile()返回的正则对象存入元组并序列化（如str()或写入文件）时，其字符串表示会被意外截断——这并非数据丢失，而是re.Pattern.__repr__的内部限制所致；根本解决需避免依赖str(re.compile(...))，改用持久化方案。
-
pytest_runtest_logreport不适合脱敏，因为它仅接收已字符串化的report（如longrepr、capstdout），不接触原始参数、断言表达式或日志record对象；敏感信息在进入该hook前就已固化为不可逆文本，正则替换易漏误伤且无法覆盖动态值。
-
特征标准化不直接提升精度，但能增强训练稳定性与收敛速度；KNN、SVM、带正则的线性模型、神经网络等对量纲敏感的模型必须标准化；须用训练集统计量统一转换训练/测试集，且需先处理缺失值、离群点及区分特征类型。
-
直接赋值绕过验证因无@property时属性为普通变量；@property提供受控访问，需配套setter实现校验，命名须一致且存储变量用下划线区分，初始化通常绕过setter以避免重复校验。
-
finally不一定执行，仅当os._exit()终止进程或finally内抛未捕获异常时跳过；sys.exit()不影响finally执行；推荐用with而非手动try-except-finally管理资源。
