Python类型提示仅用于静态分析，运行时不解析、不校验；需借助mypy等工具做静态检查，或pydantic/ […]

避免循环导入需延迟导入、提取公共模块或用字符串类型注解；__init__.py应仅定义接口和轻量导出，禁放耗时 […]

带参数装饰器必须是三层函数，因为@decorator(arg)先调用decorator(arg)返回真正的装饰 […]

必须用 typing.Self 当需让类型检查器推导出调用者具体子类而非父类，避免链式调用中类型退化；适用于可 […]

Python函数注解本身不改变程序行为，但能提升可维护性、协作效率和工具支持能力；它明确类型意图、减少运行时错 […]

类型注解本身不直接生成文档，但为Sphinx、pdoc等工具提供函数签名、参数及返回值类型依据，结合docst […]

MySQL全文索引需建在MyISAM或InnoDB表上，PHP仅调用其FULLTEXT功能；InnoDB要求≥ […]

Python函数文档规范化核心是用Google/NumPy风格docstring，明确Args、Returns […]

Python注释只能用#，三引号字符串不是注释；docstring必须位于模块/函数/类定义正下方首行，用&# […]

Sphinx生成Python文档的关键是代码与文档协同演进。需配置autodoc插件、规范docstring（ […]