写作《Flask Web开发实战》花费了一年多的时间，在这期间，除了编写5个项目实例和写作外，我还花了一部分时间来和书中涉及的Python库（主要是Flask扩展）打交道。这篇文章总结了这本书的写作给整个Flask社区带来的一些改变。

国内第一本Flask书

虽然国内已经有几本书介绍过Flask，但都是顺便介绍，而不是真正意义上的Flask书。因此，这本书可以说是国内第一本Flask书，很高兴能为国内的Flask社区带来这样一本书。希望这本书能够推动更多人了解和使用Flask，进而为社区贡献更多的力量。

完善多个项目

在实际介绍和使用某个库时，总会遇到各种各样的问题，主要有两类：

• 不完善的用法或实现

Bug不用多说，肯定要处理。对于不完善的用法和实现，如果沿用原来的代码，一来不容易读者理解，二来还需要在书中加进很多不必要的内容。所以，我更倾向于让这些代码变得更好一点。

如果把不完善的实现写到书里，我会觉得非常不舒服。比如说，WTForms本身是支持设置内置的错误消息的语言的，我们可以设为中文，而不用手动写错误消息。但是在Flask-WTF中，因为内部重写了相关方法，导致没法在不使用Flask-Babel的情况下使用内置的翻译。问题来了：如果在第4章介绍Flask-Babel和i18n等相关概念的话，这显然需要占据大量篇幅，并不合适，而且这部分内容已经计划加入到第10章。

为此，书的安排没法改动，那么只好调整Flask-WTF的内部实现，所以就有了这个PR。类似的情况还有很多，比如Firefox支持headless模式后，Selenium中却没有提供和Chrome相同的导入接口；Flask-OAuthlib中，传入access令牌只能使用元组或字典类型，而不能使用更直观的字符串变量传入……

下面是一些写作期间提交的开源贡献：

推动发布新的版本

除了让PR被合并，还要让这些项目发布新的release，这样才能在项目源码公开后，让读者可以正常使用。在我的推动下，Flask-OAuthlib、Flask-Whooshee和Flask-Moment都发布了新的版本。

其他的项目，除了Werkzeug以外，大部分都在整个写作的时间跨度发布了新的版本。尤其重要的是Flask的1.0版本。从书一开始写作，我就直接采用了主分支的代码，书中我直接将版本号写为0.13。如果Flask迟迟不发布新版本，那我会陷入一个很尴尬的境地：要么大胆采用主分支代码，但是可能会出现变动，导致书中的内容不可靠；要么采用旧版本，那书出版后可能会很快面临过时的危险。还好，在写作接近尾声的4月末，新版本1.0发布了。

4个Flask扩展

用于集成Bootstrap的扩展Flask-Bootstrap目前的维护状态很糟糕：上一次release是17年1月，上一次合并commit是17年3月，而且已经很长时间不再处理PR和Issue。

原项目还存在很多问题：Jinja语法不标准、内置基模板引入不必要的复杂度、分页宏不支持传入URL片段值。除此之外，让我决定写新的扩展替代它的最主要原因是因为它不支持Bootstrap 4，而我不能接受在书中引入一个这样过时的项目。

为了解决这些问题，只好写了Bootstrap-Flask。最终决定写替代扩展的时候，书已经完成了三分之二，大量旧的内容和源码都要改写。把书稿和源码从Flask-Bootstrap和Bootstrap3迁移到Bootstrap-Flask和Bootstrap4是一个非常痛苦的过程，到现在还记忆犹新……

对于某些空白的领域，我写了三个扩展来简化集成操作：

• Flask-Avatars：头像处理
• Flask-Dropzone：集成Dropzone.js，提供文件上传的客户端处理
• Flask-CKEditor：集成富文本编辑器CKEditor

5个Flask开源项目

在此之前，完善的Flask开源项目屈指可数，除了Flask官方提供的两个示例程序外，就只有Miguel Grinberg的两个程序。而这本书带来了5个相对比较完善、所有依赖都基于最新版本的开源项目（严格来说，第1个程序比较简单，可以排除在外）：