-
typing.overload是用于为同一函数名声明多个类型签名的装饰器，仅供类型检查器使用，不执行逻辑；真实实现由后续未装饰的同名函数承担，且必须严格遵循先重载声明、后具体实现的结构。
-
requirements.in仅声明顶层依赖及宽松版本约束，由pip-compile自动生成含精确版本与哈希的requirements.txt；前者人工维护、进Git，后者机器生成、确保环境一致。
-
要将PyCharm设置为中文界面，按照以下步骤操作：1.启动PyCharm，点击右下角地球图标，选择“中文（简体）”或“中文（繁体）”，并重启应用。2.在“Editor”->“Font”中选择支持中文的字体，如“MicrosoftYaHei”或“SimSun”。3.在“Editor”->“FileEncodings”中设置为“UTF-8”。这样可以确保界面变成中文且中文字符正确显示。
-
应优先用defaultdict替代普通字典防KeyError，它通过工厂函数（如int、list）为缺失键提供默认值，仅方括号访问时触发；与setdefault()相比更适于键值关系固定、反复增删的场景。
-
列表推导式必须用方括号，圆括号是生成器表达式；字典推导式必须有冒号分隔键值；集合推导式去重但不保序；嵌套推导式默认扁平化，需双层方括号实现二维结构。
-
ConnectionResetError通常因对端关闭连接导致，需通过异常捕获、重试机制和连接复用优化处理。
-
Pandasgroupby变慢主因是默认行为导致冗余计算与隐式拷贝；优化需优先用agg指定列和函数、提前过滤投影、转category类型、设as_index=False和observed=True，超大数据改用Dask/Polars/DuckDB。
-
Python缓存设计核心是选对策略、控好粒度、管住生命周期；需依场景选用@lru_cache、redis-py、diskcache等工具，规范键设计，合理设置失效策略，并实施击穿、雪崩、穿透防护。
-
默认hashlib.md5()处理大文件慢的主因是IO读取方式不当，而非算法本身；优化需控制块大小（SATA用64KB、NVMe用1–4MB）、避免内存拷贝、合理并发（预分片+mmap+memoryview），并注意OpenSSL直调的适用条件与资源泄漏风险。
-
在Python中检查文件是否存在可以使用以下方法：1.使用os.path.exists()，但它不能区分文件和目录；2.使用os.path.isfile()，它只对文件返回True；3.使用pathlib.Path.is_file()，适用于Python3.4及以后版本。检查多个文件时可以使用列表推导式，但需注意性能问题。
-
pytest通过@pytest.mark.parametrize参数化browserfixture实现Chrome和Firefox并行测试，需配置匹配的驱动版本、CI专用启动参数（如--headless=new）及正确清理driver。
-
PydanticV2的model_validate比V1的parse_obj快1.5–2.8倍，实测10万条5层嵌套数据耗时1.32svs3.47s，主因是改用typing.Annotated和编译式验证逻辑。
-
np.diag()一维输入生成对角矩阵，二维输入提取主对角线；误传二维数组易得错误结果；需偏移用k参数；dtype不自动继承；np.diagflat()先展平再构造，更鲁棒；大矩阵应避免显式构造以节省内存。
-
Actor和Critic必须双头分离输出：Actor输出logits（离散）或均值/对数标准差（连续），Critic输出标量value；loss计算需在tf.GradientTape内完成，advantage需stop_gradient，环境交互须适配Gym新API并统一数据类型与shape。
-
Python函数参数支持位置参数、关键字参数、args和*kwargs，需按序混合使用；返回值可单个、多个或None；作用域遵循LEGB规则，注意可变对象传参的引用特性。
