重要提示:alembic 不支持直接修改表名称、列名称。其处理的方案是新增一个表、字段 后删除原有的； 这样的结果会造成！！！数据丢失的严重后果！！！ 即：所有修改字段名称，表名 的操作，用命令行生成版本脚本后必须 进行review ，将删除，添加操作注释后，手动添加upgrade 和downgrade 函数中的alter 操作！！！ 每次操作alembic 会在数据库中记录相应的当前版本号。 谨慎操作！！！ 操作流程： 1. 针对修改字段名称的，可以手动修改version 文件，把add_column , drop_column 替换为alter_colunm 2. 针对修改关联字段操作，可以先添加新的字段，然后切换相关的关联信息，然后在下一个版本中删除该字段

apidoc 的优势： 1. UI 还算可以， 2. 可以模拟请求 3. 对原有运行环境无伤害（仅需在开发机器上安装 nodejs 和 apidoc 就可以正常使用，无需对运行环境和项目做结构性修改） apidoc 的劣势： 1. 不能本地导出，但是可以通过安装应用包，先导出md文件，然后再转存各种文档格式 2. 注释代码量有点大；几乎所有的文档信息都要通过注释来提现 其他工具存在的问题 1. 需要修改代码结构，2. 对py2.7 支持不友好 如Flask-Docs， 3.配置和使用有定复杂