click命令不能直接用flask run方式启动，因为click不处理wsgi生命周期且不感知flask应用上下文；需通过app.cli注册以自动注入上下文，否则调用current_app或db会抛出runtimeerror。
Click命令为什么不能直接用flask run那种方式启动？
因为Click本身不处理WSGI生命周期，也不感知Flask应用上下文。你写一个@click.command()函数，它默认在模块顶层执行，此时current_app根本没被激活，调用db.create_all()或app.config['DEBUG']会直接抛RuntimeError: Working outside of application context。
正确做法是把Click命令绑定到Flask实例上，用app.cli.add_command()注册——这会让Click自动注入应用上下文，所有with app.app_context():逻辑都由框架代劳。
- 别在
if __name__ == '__main__':里调用cli()，那是纯Click项目才这么干 - Flask 2.0+ 默认提供
app.cli，不用额外装flask-cli - 命令函数参数里别硬写
app或db，它们应该从上下文中获取（比如from flask import current_app）
如何让自定义命令支持--env切换配置并加载对应数据库？
Click原生不识别Flask的FLASK_ENV或FLASK_CONFIG，但你可以用@click.option('--env', default='development')手动传参，再在命令体内根据值导入不同配置类。
关键点在于：配置必须在应用工厂函数中完成，不能在命令里临时改app.config——否则扩展（如SQLAlchemy）可能已按旧配置初始化过了。
- 推荐结构：命令只负责触发
create_app(env=env)，而不是app.config.from_object(...) - 如果要用环境变量驱动，
os.environ['FLASK_ENV'] = env必须在create_app()调用前设置 -
--env production和--env testing要对应实际存在的配置类名，拼错会ImportError
批量插入数据时，为什么click.confirm()后还是卡住不动？
常见原因是用了db.session.add_all()但忘了db.session.commit()，或者事务被异常中断后没回滚。Click命令默认不开启自动提交，而Flask-SQLAlchemy的session在CLI上下文中不会像Web请求那样自动commit或rollback。
更隐蔽的问题是：某些数据库驱动（如SQLite）在未显式commit时，后续查询会阻塞等待锁释放。
- 务必在
try/except块里包裹操作，成功则db.session.commit()，失败则db.session.rollback() - 避免在循环里频繁
add()后立刻commit()，性能差；改用bulk_insert_mappings()或分批次提交 -
click.confirm('确认清空表？') == False时，要return退出函数，否则继续执行后面逻辑
如何复用Web路由中的工具函数而不引发循环导入？
比如你想在CLI命令里调用utils.send_email()，但它内部依赖了current_app，而该模块又import了app——这时如果CLI模块在顶层import了utils，就会在Flask应用创建前触发导入，导致RuntimeError。
解法是延迟导入：把import语句放到命令函数内部，确保此时应用上下文已就绪。
- 错误写法：
from utils import send_email放在文件顶部 - 正确写法：
def send_bulk_emails():函数体内写from utils import send_email - 如果工具函数本身需要初始化（如连接Redis），应在
with app.app_context():块内调用
CLI命令最容易出问题的地方不是语法，而是上下文时机——什么时候能访问current_app，什么时候db已经绑定了引擎，这些边界比代码行数更难调试。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
