faker非线程安全，需按需创建实例并显式指定locale；add_provider是实例方法而非类方法；批量插入应使用bulk_insert_mappings；cli命令须确保app context和db已初始化。
Flask里直接import faker就能用，但别在app工厂里初始化全局实例
Faker不是线程安全的，如果在create_app()里初始化一个全局Faker()实例，多 worker（比如gunicorn）或并发请求时可能混用 locale、混用 provider 状态，导致生成重复 ID 或格式错乱。应该按需创建，或者用threading.local隔离，更简单的是：每次需要数据时 new 一个。
常见错误现象：Faker().name() 在循环里反复调用却返回相同名字；或中文 locale 下生成出英文地址。
- 正确做法：在数据生成函数内部创建
Faker('zh_CN')，显式指定 locale - 避免把
fake = Faker('zh_CN')写在模块顶层或 app 初始化块里 - 若需复用（比如 CLI 命令批量插入），可封装成函数参数传入，而非全局变量
用faker.providers自定义字段时，register_provider必须在Faker实例上执行
很多人照着文档写from faker import Faker; Faker.add_provider(MyProvider)，结果报错AttributeError: type object 'Faker' has no attribute 'add_provider'——因为add_provider是实例方法，不是类方法。
使用场景：你要生成带业务规则的 mock 数据，比如订单号固定前缀+时间戳+随机码，或用户等级按权重分布。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
- 先定义 provider 类，继承
BaseProvider - 然后
fake = Faker(); fake.add_provider(MyProvider) - 不能对
Faker类本身调用add_provider，否则直接报错 - 多个 locale 下要分别注册，
Faker('en_US')和Faker('zh_CN')是两个独立实例
批量插入数据库时，别用db.session.add()逐条提交
在 Flask-SQLAlchemy 里，用db.session.add()循环加 1000 条记录再commit()，性能极差，可能卡死或 OOM。SQLAlchemy 的 session 会缓存所有对象，内存占用随数量线性增长。
性能影响：插 1w 条用户，逐条 add 耗时可能超 2 分钟；用bulk_insert_mappings通常在 2 秒内完成。
- 优先用
db.session.bulk_insert_mappings(Model, list_of_dicts) - dict 键名必须和 Model 字段名完全一致（包括大小写）
- 不触发 ORM 事件（如
@validates、before_insert），如有依赖逻辑，得手动处理 - 外键关联字段要填真实存在的 ID，bulk 操作不校验约束，填错只会 commit 失败
CLI 命令生成数据时，注意 app context 和 db 初始化时机
写 Flask CLI 命令（比如flask seed --count=5000）时，常遇到RuntimeError: Working outside of application context或AttributeError: 'NoneType' object has no attribute 'session'，根本原因是没激活 app context 或 db 尚未 init_app。
容易踩的坑：在命令函数开头就 import model，但此时db还没绑定到 app。
- 命令函数必须用
@with_appcontext装饰 - 确保
db.init_app(app)已在create_app()中执行，且 CLI 命令在 app 创建后注册 - 不要在命令里重新
init_app，会导致连接池重复初始化 - 生成过程中用
print(f"✅ inserted {i}/5000")做进度提示，避免误以为卡死
User.name对应fake.name()，但User.avatar_url需要fake.image_url()，而后者不在默认 provider 里，得装faker-image并手动add_provider。这种细节不提前试，跑一半才发现字段空着，又得回退重来。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
