Skip to content

Latest commit

 

History

History
514 lines (464 loc) · 45.4 KB

errata.md

File metadata and controls

514 lines (464 loc) · 45.4 KB
Raw

勘误

请访问 http://helloflask.com/book/errata 阅读勘误，这里是勘误源码。

如果你发现了书中的错误，欢迎提交PR更新勘误文件；你也可以创建Issue指出相关错误，或是通过Email与我联系（[email protected]），谢谢！

最后更新：2019/3/17

勘误贡献者列表

统计时间：2019/4/22（排名不分先后）

另外还有通过 QQ、Telegram 和 Email 反馈勘误的读者，不方便索引，这里没有一一列出。感谢你们的贡献！

纸书

纸书的版本号格式为“版本号-印次号”，“1-1”即“第 1 版第 1 次印刷”。每一次重印会修正上一印次包含的所有错误，版本号可以在版权页看到。

1-1（第 1 版第 1 次印刷）

发布时间：2018/9/1

重要勘误

此处的勘误为会影响程序运行和理解的错误，需要在阅读前标记到书上，以免影响阅读。

位置 错误 正确 备注/时间
1.2.2.2 P13 代码清单1-3下第2段第2行 http://helloflask.com/hello/Grey http://helloflask.com/greet/Grey 笔误
1.7 P23 第2个代码块下第1行 url_for('say_hello', name='Jack') url_for('greet', name='Jack') 笔误
2.2 P30 请求报文示例表格 URL /hello 改为 http://helloflask.com/hello?name=Grey 19.2.2
2.2 P30 请求报文示例表格 去掉主体一栏的内容 19.2.2
2.2 P30 请求报文示例表格下方正文 如果 URL 中包含查询字符串，或是提交了表单，那么报文主体将会是查询字符串和表单数据。 如果提交了表单，那么报文主体将会是表单数据（查询字符串通常会直接通过 URL 传递）。 19.2.2
2.2 P31 命令行输出 /hello /hello?name=Grey 19.2.2
2.2.1 P31 表2-3左侧下面的两行 POST对应的说明列原文为“传输数据”，修改为“创建或更新资源”；PUT对应的说明列原文为“传输文件”，修改为“创建或替换资源” 改进 18.11.18
2.2.3.1 P34 最下方终端输出第四行的Rule /goback/<int:age> /goback/<int:year> 笔误 19.03.07
2.2.3.3 P36 表2-6后第1个代码块 'goback/<int:year>' '/goback/<int:year>' 笔误。 18.9.28
2.3.1 P40 第3个代码块 {'Location', 'http://www.example.com'} {'Location': 'http://www.example.com'} 笔误。返回值中字典里的符号出错
2.3.2 P44 HTML小节的最后1行 HTTP HTML 笔误
2.3.2.4 P46 倒数第3个代码块 return jsonify({name: 'Grey Li', gender: 'male'}) return jsonify({'name': 'Grey Li', 'gender': 'male'}) 笔误。字典键加引号 18.10.18
2.2.3 P48 图2-11 图中的响应状态码应该为 302 Found 文图不对应 18.10.18
2.3.4.2 P50 代码清单2-5下第1段第3行 logged-in cookie logged_in cookie 排版错误 18.11.8
2.3.4.2 P51 图2-12后第1个代码块 第9行及以下均应向左缩进4个空格 排版错误 18.10.18
2.3.4.2 P52 图2-13后第1段第2行 logged-in logged_in 排版错误 18.11.8
2.3.4.2 P52 代码清单2-6下第2段第2行 logged-in logged_in 排版错误 18.11.8
2.5.1 P57 最后一个代码块中的URL规则 /do_something /do-something 与源码不符 19.03.08
2.5.4.1.(2) P67 “攻击示例”小节第3段文字第2行 设为 “';drop table users; --” 设为 “';drop table students; --” 笔误 18.11.2
3.4.3 P99-P100 每段正文中（共三处） get_flashed_message() get_flashed_messages() 笔误 19.03.09
4.2.1 P108 第一段正文第一行 name username 与实际项目不符 19.03.10
4.2.3 P110 代码清单4-2最后1行 'login.html' 'basic.html' 笔误 18.9.28
4.3.1 P112 第1个代码块后第1行 3000 2000 笔误，不同的浏览器对于URL有不同的长度限制，此处长度为“最佳实践”
4.3.1 P113 代码清单4-5第1行 '/' '/basic' 笔误 18.10.18
4.3.2.2 P115 第 2 小节的代码块第 5 行 Length(8, 128) Length(6, 128) 前后不一致（1-3 重印时需要反过来调整另外 3 处），18.12.28
4.3.2.3 P115 第二段正文第一行 basic_form 视图 basic 视图 笔误 18.03.10
4.3.2.3 P115 下方代码块最后一行第一个参数 'forms/basic.html' 'basic.html' 笔误 19.03.10
4.3.3 P117 正文最后第二行 长度小于6 长度小于8 与实际项目不符 图4-4同理 19.03.10
4.4.4.3.(3) P127 第四段正文第二行 这个uploads视图 这个get_file视图 笔误 18.10.27
4.4.4.3.(3) P127 第五段正文第二行 ...模板中将从 session 获取... ...模板将从 session 中获取... 句子不通顺 19.03.11
4.4.4.4 P128 代码清单4-16 “检查文件类型”注释下第一行多余缩进4格 笔误 18.10.18
5 P139 第 1 个代码块 $ flask run 上面添加一行 $ flask initdb # 初始化数据库，后面会详细介绍 疏漏 19.1.5
5.1.2.1 P140 记录的文档表示的第四行 sex: "Male" sex: "Male", 标点缺失 19.03.12
5.2 P141 第一个SQL代码块第三行 去除末尾的**,**逗号 标点错误 19.03.12
5.3.3 P146 代码清单5-3下方正文 flask inintdb flask initdb 笔误 19.03.12
5.4.1.1 P147 ”Create“小节第1个代码块第4行 'DON'T BELIEVE……' 'DON\'T BELIEVE……' 代码错误，漏掉转义符号
5.4.1.2 P150 表5-7下的第1个代码块 Note.body='SHAVE' Note.body == 'SHAVE' 代码错误，少了1个等号 18.9.22
5.4.2 P153 代码清单 5-5 删掉第 3 行，最后一行删除括号中的, form=form 代码未更新 18.12.24
5.4.2 P155 代码清单 5-8 第 3 行 DeleteForm() DeleteNoteForm() 代码未更新 18.12.24
5.5.2 P158 代码清单 5-10 第四行第一个参数 db.String(70) db.String(20) 与源码不符 19.03.13
5.5.2.3 P160 ”建立关系“小节第1个代码块 第2行插入ham.author_id = 1 省略步骤，可加可不加 18.9.22
5.5.2.4 P162 代码清单5-11第3行 db.String(70) db.String(64) 与源码不符 19.03.15
5.5.2.4 P162 代码清单5-11第8行 title = name = 笔误 18.9.26
5.5.2.4 P163 ”建立双向关系“小节第3个代码块第6行 it.writer = writer it.writer = king 笔误 18.9.26
P164 第 2 段第 2 行和第 3 行两处 backref() 函数 db.backref() 函数 优化 19.3.7
P164 第一个代码块第 3 行 backref=backref(...) backref=db.backref(...) 错误 19.3.7
5.5.3 P164 代码清单5-13上面 都定义在“多”这一侧，即City类中 都定义在“多”这一侧，即Citizen类中 笔误
5.5.4 P165 代码清单5-14后面的代码块第6行 - 第6行>>> china.capital = beijing移动到第3行 笔误
5.5.4 P165 代码清单5-14后面的代码块第8行 <Capital 1> <Capital u'Beijing'> 笔误
5.5.4 P166 代码清单5-14后面的代码块第10行，166页第2行 u'China' <Country u'China'> 笔误
5.5.4 P166 代码清单5-14后面的代码块第11行，166页第3行 name'Tokyo' name='Tokyo' 笔误 18.9.26
5.5.5 P167 图 5-8 中 student 和 association 表之间的箭头 两张表的 id 不对应 错误 19.03.15
P167 图5-8下第二段最后一句 设为关联表名称 设为关联表对象或是字符串形式的关联表名称 19.4.23
P170 附注段落最后一句 你可以在命令行中输入flask db --help 查看 db 命令所有可用的子命令和说明。 19.4.23
5.7.1 P172 下方代码块第三行 与源码不符 去掉, unique=True约束 与源码不符 19.03.15
5.7.1 P173 上方代码块第3行 relationship('Comment', cascade='save-update, merge, delete') db.relationship('Comment', back_populates='post', cascade='save-update, merge, delete') 笔误 19.03.15
5.7.1 P173 上方代码块第3行 relationship('Comment', cascade='all') db.relationship('Comment', back_populates='post', cascade='all') 笔误 19.03.15
5.7.1 P174 倒数第2个代码块第3行 relationship('Comment', cascade='all, delete-orphan') db.relationship('Comment', back_populates='post', cascade='all, delete-orphan') 笔误 19.03.15
5.7.1.2 P174 ”delete-orphan“小节上面第1个代码块第1行 Post.quer2y.get(2) Post.query.get(2) 审校错误
5.7.2 P176-P177 正文中4处、提示段落中1处 listen_for() listens_for() 笔误 19.03.15
5.7.2 P176 代码清单5-18下第1行 targe target 笔误 18.9.28
5.7.2 P177 最后1个代码块上面 参数name 参数named 笔误 18.9.28
5.7.2 P177 最后1段提示文字 监听函数时， 监听函数。这时 编辑瞎改稿子 18.9.28
5.7.2 全章节多处 listen_for listens_for 笔误 18.9.28
6 P182-P191 全章节多处 代码清单中发送邮件的函数名与源码不一致 见源码 19.03.17
6.1.1 P181 代码清单6-1 第9-13行末尾漏掉分割参数的逗号 笔误 18.10.27
6.2.3.3 P187下方代码块 P188 代码清单6-4 os.environ.get() os.getenv() 19.03.17
6.2.3.3 P188 代码清单6-4 整段代码和源码有很多不同 见源码 19.03.17
6.3.2 P190 第一段正文 HMTL HTML 笔误 19.03.17
7.3.2 P208 第1个代码块第6行 render_form(form),action=request.full_path render_form(form, action=request.full_path) 审校错误，右侧关闭括号位置出错
7.3.2 P208 表7-2上面段落的最后一句话 quick_form() render_form() 笔误。历史遗留问题 18.9.28
7.4.3 P213 最后 1 个附注段落 bootstrap.bundle.min.css bootstrap.bundle.min.js 笔误 18.12.5
P255 下面代码块第 10 行 去掉中部的 class="next
P269 去掉页面中部的提示段落
8.1.3 P229、P231 代码清单8-2、8-4 单个蓝本变量名称均应为foo_bp形式，比如admin应为admin_bp 笔误 18.9.24
8.2.1.1.(4) P235 代码清单8-7后面第1个代码块第3行 db.relationship('Comment', backref='post', cascade='all') db.relationship('Comment', back_populates='post', cascade='all, delete-orphan') 笔误
8.2.3 P247 代码清单8-19第2行 from wtforms from wtforms.validators 笔误 18.10.27
8.3.1 P252 第1个代码块最后1行 'index.html' 'blog/index.html' 笔误 18.10.06
8.3.1 P252 代码清单8-24文件路径 templates/index.html templates/blog/index.html 笔误 18.10.06
8.3.5 P263 第1个代码块第6行 Comment.query.with_parent(post) Comment.query.with_parent(post).filter_by(reviewed=True) 笔误 18.9.26
P263 代码清单 8-29 第 2 行 {{ comments|length }} Comments {{ pagination.total }} Comments <!-- 使用 pagination.total 获取分页条目总数 --> 优化 19.3.5
8.3.5 P264 代码清单 8-29 倒数第11行 Reply</a> Reply</a></div> 笔误 18.12.6
8.3.5 P265 图 8-8 上的代码块第2行 {{ comment.replied.author.name }} {{ comment.replied.author }} 笔误 18.12.6
8.3.7 P267 代清清单8-31第4行 comment.photo_id comment.post_id 笔误 18.9.26
8.3.7 P267 代清清单8-31下方正文第2段最后一行的URL中 photo post 笔误 18.9.26
8.3.7 P268 第1行 photo show_post 笔误 18.12.6
8.4.1 P272 第1个代码块最后1行 >>> False >>> True 笔误 18.10.27
8.4.1 P273 纸书该页第 2 个代码块，电子书 8.4.2 上面倒数第 2 个代码块。第 5、7 行 check_password validate_password 笔误 18.12.6
8.5 P275 “8.5”小节下第2个代码块第2行 LoginManager(app) LoginManager() 代码错误 18.12.23
8.5.3 P278 代码清单8-37代码块第1行 from flask_login import logout_user from flask_login import logout_user, login_required 完善导入 18.12.6
8.6 P282 代清清单8-38第4行 '400.html' 'errors/400.html' 笔误 18.10.27
8.7.1 P285 代码清单8-40下的正文第1行 manage_category.html manage_post.html 笔误 18.10.27
8.7.1.2 P288 代码清单8-42代码块倒数第2行 .show_post blog.show_post 笔误 18.12.6
8.7.1.3 P290 第1个代码块倒数第5行 .show_post blog.show_post 笔误 18.12.6
8.7.2 P292 代码清单8-44代码块倒数第1行 .show_post blog.show_post 笔误 18.12.6
8.7.2.2 P294 代码清单8-45代码块下正文第1行 Ture True 笔误 18.12.6
9.1.1 P302 9.1.2 标题上面的代码块 bluelog myapp 笔误 18.12.6
P309 代码清单 9-2 倒数第 6 行 field.data field.data.lower() 优化 19.3.5
9.3.2.2 P314 代码清单9-6代码块最后1行 url_for('.resend_confirmation') url_for('.resend_confirm_email') 笔误 18.12.12
9.3.3 P315 代码清单9-8下的正文第2段第2行（纸书该页最后1行） auth.resend_confirmation auth.resend_confirm_email 笔误 18.11.5
P332 图 9-4 下面第 2 行 dropzone_upload 视图 upload 视图 错误 19.3.5
9.5.3 P334 9.6 小节上面的代码块最后一行模板字符串 home/upload.html main/upload.html 遗留代码未更新 18.12.17
9.5.3 P334 代码清单9-19后面的代码块倒数第二行 photo.save() db.session.add(photo) 换行 db.session.commit() 遗留代码未更新 18.10.27
P360 代码清单 9-41 倒数第 2 行和倒数第 8 行两处 self.collected Collect.query.with_parent(self) 错误 19.3.5
P363 代码清单9-45 倒数第 6 行 collections collects 错误 19.3.5
P363 代码清单9-45 第 3 行 ... import user_card with context %} ... import user_card %} 提前 19.3.5
P367 正文第 3 行 if_following() is_following() 错误 19.3.5
9.8.3 P363 代码清单9-45代码块倒数第6行 {% if collections %} {% if collects %} 笔误 18.12.10
P368 第 2 段第 2 行 去掉“和 is_followed_by()” 多余内容 19.3.5
9.9.4 P371 代码清单9-53的路径 albumy/templates/profile_popup.html albumy/templates/main/profile_popup.html 笔误 18.12.21
9.9.4 P375 代码清单 9-56 下面的代码块第二行 id="followers-count" id="followers-count-{{ user.id }}" 笔误 18.12.21
9.11.2 P388 最后一行 渲染avatar.html模板 渲染change_avatar.html模板 笔误 18.12.10
9.11.2 P389 第一个代码块下正文第1行 avatar.html模板继承自settings.html模板 change_avatar.html模板继承自settings/base.html模板 笔误 18.12.10
9.11.2 P389 代码清单9-71代码块第1行 {% extends 'user/settings.html' %} {% extends 'user/settings/base.html' %} 笔误 18.12.10
9.11.2 P389 代码清单9-71倒数第4行 {{ render_form(crop_form) }} {{ render_form(crop_form, action=url_for('.crop_avatar')) }} 笔误 18.12.24
9.11 P385 代码清单9-66倒数第9行 {{ render_nav_item('user.notification_setting', 'Notification and Privacy') }} {{ render_nav_item('user.notification_setting', 'Notification') }} {{ render_nav_item('user.privacy_setting', 'Privacy') }} 代码与实际项目不符 18.12.24
P395 第 1 个代码块第 3 行 show_collections public_collections 错误 19.3.5
P396 提示段落 show_collections public_collections 错误 19.3.5
9.11.6 P397 代码清单9-79代码块倒数第5行 current_user current_user._get_current_object() 笔误 18.12.10
P406 代码清单 9-85 第 3 行 在这一行最后紧跟着括号添加（注意不要漏掉开始的英文句点） .strip() 优化，避免输入空格作为搜索词 19.3.5
P412 代码清单 9-90 倒数第 3 行 field.data field.data.lower() 优化 19.3.5
P417 文件目录树倒数第 6 行 app.py todo.py 错误 19.3.5
10.1.1 P420 第 2 小节第一个代码块第 7 行 {{ url_for('todo.clear_item') }}; {{ url_for('todo.clear_items') }}; 笔误 18.12.27
10.1.4 P425 第一个代码块第 6 行 jsonify(message='Invalid item body.'), 400 return jsonify(message='Invalid item body.'), 400 笔误 19.1.20
10.3.3 P447 第 1 小节/该页最后一个代码块 ... import api ... import api_v1 笔误 18.12.28
10.3.3 P447 第 1 小节/该页最后一个代码块 csrf.exempt(api) csrf.exempt(api_v1) 笔误 18.12.28
第10章 P451 class Item(MethodView) class ItemAPI(MethodView) 19.4.23
10.3.3 P453 代码清单10-13第一行中的methods参数 methods=['GET', 'POST'] methods=['GET'] 与原定的方法不一致 18.12.28
10.3.3 P453 代码清单10-13第二行中的第一个参数 '/token' '/oauth/token' 与实际项目不一致 18.12.28
10.3.3 P453 代码清单10-13第二行中的methods参数 methods=['GET'] methods=['POST'] 与实际项目不一致 18.12.28
10.3.5 P462 代码清单10-20倒数第4行 item.author, item.author.username, 笔误 18.12.28
10.3.6.3 P468 ”处理错误响应“小节第1行 app.error_handler app.errorhandler 笔误
11.3.2 P483 代码清单11-4倒数第2行 花括号"}"后添加一个逗号"," 笔误 18.12.28
11.3.2 P484 代码清单11-5第2行 $('message') $('.messages') 笔误 18.12.28
11.4.1 P491 该节最后一段正文的第1行 views包 blueprints包 笔误 18.12.29
11.4.3 P498 附注段落下方正文第2行 provide_name provider_name 笔误 18.12.29
11.4.3.5 P503 代码清单11-11中多处 get['XXX'] get('XXX') 审校错误
11.4.3.5 P503 最后一个代码块 access_token = resp.get('access_token') access_token = response.get('access_token') 笔误 18.12.29
11.4.3.6 P505 提示段落上方的代码块 @oauth_bp.route(...) @auth_bp.route(...) 笔误 18.12.29
11.4.4 P506 第二个代码块 所有resp 改为 response 笔误 18.12.29
11.4.4 P506 第二个代码块 增加 if response is not None:... else:...语句，具体参考源码 笔误 18.12.29
11.5.1 P508 代码清单11-12 '_messages.html' 'chat/_messages.html' 笔误 18.12.29
11.5.1 P509 代码清单11-13第5行 position === 0&& socket.nsp! == '/anonymous' position === 0 && socket.nsp !== '/anonymous' 审校错误，空格错误 18.12.29
11.5.1 P510 代码清单11-13倒数第6行 toast('No more messages.'); alert('No more messages.'); 此项目中未定义toast函数 18.12.29
11.5.3 P513~P514 513页7处，514页8处 所有的 Pyments 改为 Pygments，pyments 改为 pygments 笔误 18.11.18
11.5.4 P516 代码清单11-15第3行 'message' 'new message' 笔误 18.12.29
11.5.4 P516 代码清单11-15第6行 document.title = '(' + message_count + ') ' + document.title; document.title = '(' + message_count + ') ' + 'CatChat'; 消息数量会随着事件多次发生而不断追加在原标题前 18.12.29
11.5.5 P517 代码清单11-17第6行 data.name data.nickname 笔误 18.12.30
11.5.5 P517 代码清单11-17第7行 icon: ... icon: data.gravatar 笔误 18.12.30
11.5.5 P518 最后1个代码块第5行 '_message.html' 'chat/_message.html' 笔误 18.12.30
11.5.5 P518 最后1个代码块第6行字典的值 message_body html_message 笔误 18.12.30
12.3.1 P526 代码清单12-1 setUp方法最后面追加一行代码self.client = app.test_client() 代码缺失 19.01.05
12.3.2 P527 提示段落下方的正文第3行 assertEqual() assertTrue() 笔误 19.01.05
12.3.2 P527 代码清单12-3 test_404_page方法的注释 # 测试 400 错误页面 # 测试 404 错误页面 笔误 19.01.05
12.3.3 P534 代码清单12-6最后1个导入语句 from bluelog.models import User from bluelog.models import Admin 笔误 19.01.06
540 注释优化 「定位输入按钮」改为「定位输入框」，按下按钮改为「按下回车键」 19.4.23
13.1.2 P550 代码清单13-1 @app.after_app_request @app.after_request 笔误 19.01.06
13.1.2 P550 代码清单13-1 两处current_app改为app 笔误 19.01.06
13.3 P557 命令行命令 $ cd cache $ cd assets 笔误 19.01.06
14.3.4.1 P569 代码清单14-1上方正文 register_logger() register_logging() 与实际源码不符 19.01.21
14.3.4.1 P569 代码清单14-1 register_logger() register_logging(app) 与实际源码不符 19.01.21
14.3.4.1 P569 代码清单14-1 RotatingFileHandler的第一个参数 os.path.join(basedir, 'logs/bluelog.log') 与实际源码不符 19.01.21
14.3.4.2 P570 代码块 register_logger() register_logging(app) 与实际源码不符 19.01.21
14.3.4.3 P571 代码清单14-2 register_logger() register_logging(app) 与实际源码不符 19.01.21
14.3.4.3 P571 代码清单14-3 register_logger() register_logging(app) 与实际源码不符 19.01.21
14.3.4.3 P571 代码清单14-3 5处os.getenv() app.config[] 与实际源码不符 19.01.21
14.4.3.1 P576 提示段落第二行 C/Users/Administrator/.ssh C:\Users\Administrator.ssh 错误 19.01.21
14.4.7 P584 倒数第2个代码块上方段落第5行 放在/etc/supervisord.conf路径下 放在/etc/supervisor/conf.d路径下 笔误 18.11.28
15.5 P611 正文第5行 在模板中提供load()方法资源。 在模板中提供load()方法加载静态资源。 句子不完整 19.01.21
15.5.1 P612 页面中部代码块 def load(css_url=None, js_url=None): def load(css_url=None, js_url=None, serve_local=False): 与实际源码不符 19.01.21
15.5.1 P612 页面中部代码块 if current_app.config['SHARE_SERVE_LOCAL']: if serve_local or current_app.config['SHARE_SERVE_LOCAL'] 与实际源码不符 19.01.21
15.5.1 P612 页面中部代码块最后1行中的filename参数 filename='js/share.min.js' filename='js/social-share.min.js' 笔误 19.01.21
15.6.1 P614 代码清单15-8中Share类的init_app方法中的blueprint Blueprint缺少static_folder和static_url_path参数 见代码清单15-5或项目源码 笔误 19.01.21
15.6.1 P614 代码清单15-8中Share类的init_app方法 没有将扩展添加到模板上下文 添加代码app.jinja_env.globals['share'] = self 代码缺少 19.01.21
15.6.1 P614 代码清单15-8中Share类的init_app方法最后1行第2个参数 True False 与实际源码不符 19.01.21
15.6.1 P615 代码清单15-7和代码清单15-8中Share类的create方法参数 addition_class=None addition_class='' 与实际项目不符 19.01.21
15.7.3 P625 最后1个代码块的第2行 git push origm git push origin 审校错误。另外，这一行下面的Github应为GitHub
16.2.4 P639 最后1个段落的第2行 在不基于线程、greenlet或单进程实现的并发服务器上 在不基于线程、Greenlet 或进程实现并发的服务器上 笔误 18.12.31
P644 第一个代码块最后一行 name name.encode() 19.4.23
16.4.2 P649 最后1行 Flask.route()是Flask类的类方法 Flask.route()是Flask类的实例方法 笔误 19.1.1
16.4.2.1 P650 最后第2段正文第1行 view_function view_functions 笔误 19.01.21
16.4.2.2 P653 代码清单16-15中的注释 出于 处于 笔误 19.01.21
16.4.3.2 P659 第1段第3行 并将数据的字典名称设为'stack'。 并将储存上下文对象的列表名称设为'stack' 笔误 19.1.4
16.5 P680 附注第2行 Pocco风格指南 Pocoo风格指南 笔误 19.01.21

P412 添加 validate_username() 方法定义（同时添加到 1-1 勘误）：

def validate_username(self, field):
    if field.data != self.user.username and User.query.filter_by(username=field.data).first():
        raise ValidationError('The username is already in use.')

P363 正文第 1 段，原文：

我们在第 3 章曾经介绍过 Jinja2 的上下文机制，因为 user_card 宏里使用了 Flask-Login 提供的 current_user 变量，所以我们需要在导入时使用 with context 指令显式声明包含上下文：

改为：

根据第 3 章介绍的 Jinja2 上下文机制，因为 user_card 宏后面会使用 Flask-Login 提供的 current_user 变量，到时你需要为相关的导入语句追加 with context 指令显式声明包含上下文：

P393 代码清单9-74 从该页第 3 行到第 8 行，原文为：

    if form.validate_on_submit() and current_user.validate_password(form.old_password.data):
        current_user.set_password(form.password.data)  # 重设密码
        db.session.commit()
        flash('Password updated.', 'success')
        return redirect(url_for('.index', username=current_user.username))

修改为：

    if form.validate_on_submit():  # 验证表单是否通过验证
        if current_user.validate_password(form.old_password.data):  # 验证旧密码
            current_user.set_password(form.password.data)  # 设置新密码
            db.session.commit()  # 提交数据库会话
            flash('Password updated.', 'success')
            return redirect(url_for('.index', username=current_user.username))
        else:
            flash('Old password is incorrect.', 'warning')  # 旧密码不对则显示提示

P409 代码清单 9-88 在第 2 行和第 10 行（@permission 开头的两行）上面分别插入新的一行，内容为 @login_required，比如：

@admin_bp.route('/lock/user/<int:user_id>', methods=['POST'])
@login_required
@permission_required('MODERATE')

P275 8.5 小节标题上面添加提示段落：

提示 在 fakes.py 脚本里的 fake_admin() 函数中，我们需要在 admin 对象创建后，为虚拟用户记录设置密码：admin.set_password('helloflask')。

不重要勘误

此处的勘误多为单词拼写错误或不影响理解和程序运行的笔误，可以忽略。

位置 错误 正确 备注/时间
全局 单击 点击 审校错误。多处。编辑称这个修改是出版社的规范要求，我觉得有些莫名其妙
全局 代码块中的英文单词换行被截断时错误的添加的连接线 排版错误。多处，详情见下面的列表
全局 Github GitHub 大小写错误。多处
前言 V 本书主要特点中的第2点 第一部分的2~6章 第一部分的1~6章 审校错误
前言 V 本书主要特点中的第3点 Pyhton Python 拼写错误
前言 V 本书主要特点中的第3点 Boostrap Bootstrap 审校错误
前言 X 排版约定最后一段的上面1行 you_email your_email 拼写错误
1.2 P11 代码清单1-1下的提示文字 命令为 命名为 笔误
1.2.2 P13 标题1上面的附注段落 Lacator Locator 拼写错误 18.10.25
1.3.1 P14 标题 Run，Flask，Run！ Run, Flask, Run! 标点错误
1.3.1 P14 ”Run，Flask，Run“小节第1个代码块最后1行 出现多余的缩进 排版错误
1.3.1.3 P17 配置步骤4 下列选项 下拉选项 笔误
1.3.3 P18 "1.3.3"小节第1行 Enviroment Environment 拼写错误
1.8 P24 代码清单1-4 缺少下文中提到的文档字符串 见Github源码 19.03.06
2.2.2 P32 提示段落第一、三行 MutliDict MultiDict 笔误 19.03.06
2.2.2 P33 正文第一行 MutliDict MultiDict 笔误 18.12.24
2.2.2 P33 图 2-4 上面一行 requset request 笔误 18.12.28
2.2.2 P33 代码清单 2-1 最后一行 '<h1>Hello, %s!<h1>' '<h1>Hello, %s!</h1>' <h1> 关闭斜线 18.12.28
2.2.2 P33 代码清单 2-1 最后一行 该行注释缩进出错，向左移动至保留 2 个空格 排版错误 18.12.28
2.2.3 P34 图2-5 地址栏的地址应为/nothing，和描述对应。图中的/foo在后面实际被定义了 笔误 18.9.28
2.2.3.3 P36 中部代码块最后一行 多出源码中没有的<p>标签 去除<p>标签 与源码不符 19.03.07
2.3.1 P41 代码清单 2-2 第 7 行 redierct redirect 笔误 18.12.24
2.3.2.4 P45 JSON代码示例 "heading":"Remider", "heading":"Reminder", 笔误。单词拼写错误。 18.11.28
2.3.3 P47 表2-10后面的第1个附注段落 Respone Response 笔误。拼写错误
2.5.4.1.(2) P67 纸书该页第1个代码块，电子书“攻击示例”小节第2个代码块 最后的单引号和前面的分号对调位置 笔误 18.11.5
2.5.4.1.(2) P67 纸书该页第2个代码块，电子书“攻击示例”小节第3个代码块 在最后的分号前添加一个半角单引号 笔误 18.11.5
2.5.4.1.(3) P67 ”主要防范方法“小节第1个代码块 db.execute('SELECT * FROM students WHERE password=?, password) db.execute('SELECT * FROM students WHERE password=?', password) 笔误。字符串右侧引号
2.5.4 P69 纸书该页最后1行的代码块最后几个字符 sript script 笔误 18.11.5
3.1.1 P76 代码清单 3-1 文件路径 template/watchlist.html templates/watchlist.html 笔误 18.12.28
3.1 P77 代码清单3-1下的提示 HTML5 HTML 多余文本。另外，后面的链接需要更新为 https://developer.mozilla.org/en-US/docs/Learn/HTML/Introduction_to_HTML/Document_and_website_structure
3.2.4 2.自定义测试器 P86下方 我们创建了一个没有意义的baz过滤器 我们创建了一个没有意义的baz测试器 笔误 19.1.9
3.2.5 P87 正文共 5 处 enviroment environment 拼写错误 18.12.28
3.3.2 P89 第1个代码块上面的文字第2行 _macors.html _macros.html 笔误
3.3.2 P89 第1个注意段落最后1行 显示 显式 笔误 18.10.18
P89 最后一个代码块上面的段落 使用第一个列表 使用前一个列表 优化 19.3.5
3.4.1 P93 第1~4个代码块 忽略了 Jinja 本身的代码逻辑，读者可忽略 Jinja 语句含义 逻辑错误。 18.11.5
3.4.2 P97 注意段落下面正文第2行 CND CDN 笔误 18.10.27
3.4.2 P97 注意段落最后一行 Boostrap Bootstrap 笔误 18.12.28
3.4.4 P101 图3-5 地址栏的地址应为/nothing，和描述对应。 笔误 18.10.1
3.4.4 P101 图 3-5 下面第 1 行文字 处理器和模块 处理器和模板 笔误 19.1.13
4.1 P105 最后一行 ， 。 笔误 18.11.11
4.2.1 P108 表4-3下面的注意段落 内置的验证器通过…… 内置的验证器使用…… 改善措辞 18.11.5
4.2.3 P110 代码清单4-3第3行 {{ from.username.label }}{{ form.username }}<br> {{ from.username.label }}<br>{{ form.username }}<br> 改进 18.11.5
4.2.3 P110 代码清单4-3第4行 {{ from.password.label }}{{ form.password }}<br> {{ from.username.label }}<br>{{ form.username }}<br> 改进 18.11.5
4.3.3 P117 代码清单4-7第4行 form.username() form.username 笔误。此处的括号可有可无，去掉以保持风格上的统一 18.9.24
4.4.4.1 P123 代码清单4-13第1行 flask wtf flask_wtf 审校错误 18.9.24
4.4.4.1 P123 代码清单4-13第3行 字符间距过大。 排版错误 19.1.5
4.4.4.4 P128 第一个代码块第三行 ('Upload Image', validators={DataRequired()} ('Upload Image', validators=[DataRequired()]) 标点错误 19.03.11
4.4.5.2 提示段落 https://flask-ckeditor.readthedocs.io/configuration.html https://flask-ckeditor.readthedocs.io/en/latest/configuration.html 笔误 19.1.5
4.4.5 P131 代码清单4-19下正文段落第3行 Ture True 笔误 18.11.5
4.4.7 P134 代码清单4-23最后两行 两行间的行距过大 排版错误 19.03.12
4.4.7 P135-P136 两个HTML代码块中三处标题标签 <h2></h2> 标签 替换为<h3></h3> 标签 与源码不符 19.03.11
5.3.1 P143 表5-2最后1行 SQlite SQLite 大小写错误 18.10.27
5.3.3 P146 第2个代码块 开头可添加一行导入from app import Note 更完善 18.10.18
P149 表 5-6 左边一列第 1 行和第 5 行两处 ident id 优化 19.3.5
P150 表 5-7 左边一列的标题 查询过滤器名称 过滤方法 优化 19.3.5
5.5.2 P159 表5-4下的注意段落第2行 Flask-SQLlchemy Flask-SQLAlchemy 笔误 18.10.27
5.5.2 P160-P161 正文、提示段落中共四处 Aritcle / aritcles Article / articles 笔误 19.03.13
5.7.1.1 P173 中部代码块 comment1 =Comment()/comment2 =Comment() = 等号右边增加一个空格 19.03.15
5.8 P177 最后1行 本章要介绍的 本章介绍的 笔误 18.9.28
6.1.3 P183 代码清单6-3第9行 return redirect(url_for('idnex')) return redirect(url_for('index')) 笔误 18.10.27
6.2 P183 6.2及6.2.1章节标题以及目录共4处 SendGird SendGrid 笔误 18.10.27
7.2 P202 代码清单 7-3、7-4、7-7 补全路径，相应加入 sayhello/ 和 templates/ 19.2.2
7.2.3.1 P202 代码清单7-3的文件路径 sayhello.py models.py 笔误
7.2.3 P204 代码清单7-5后面的代码块第4行 messages = Message.query.order_by...向后缩进1格 缩进 19.01.11
7.3.1 P207 3.7.1节中最后一段话中 bootstrap_load_js() bootstrap.load_js() 笔误 18.11.17
7.4.3 P211 表7-4下面的提示段落 https://momentjs.com/docs/displaying/format/ https://momentjs.com/docs/#/displaying/format/ 链接变化 18.11.5
7.5 P213 最后一行代码 fake = Faker('zh_CN')) fake = Faker('zh_CN') 笔误 18.11.17
7.5 P214 该页（节）最后 2 个代码块的最后 1 行 两处均向左缩进 4 格，和上面对齐 排版错误 18.12.6
8.1 P220 文件目录树 目录树漏掉了 init.py 文件 笔误。 18.10.1
8.1.3 P229 第2个提示段落 新创建的模块 新创建一个模块 审校错误。 18.9.24
8.2.1 P237 代码清单 8-8 倒数第 3 行 删除这一行 后续内容前置 19.1.13
P237 代码清单 8-10 第 2 行 空白行写入内容 import random 优化 19.3.5
8.2.1.3 P237 代码清单8-9第10行 缩进少一格 排版错误 18.10.18
8.2.1 P239 代码清单 8-12 文件路径 bluelog/commands.py bluelog/init.py 遗留代码未更新 19.1.13
8.3.3 P261 代码清单8-27 <div class="modal-body"> 所在的行以及下面2行均向右缩进8格 排版错误 18.11.5
8.3.5 P264 代码清单8-29第12行 (%Y-%m-%dT%H:%M:%SZ') ('%Y-%m-%dT%H:%M:%SZ') 笔误，漏掉左侧引号 18.10.27
8.2.1 P240 8.2.2 标题上面的代码块 三个点那一行应该向左缩进 4 格，和上面的美元符号对齐 排版错误 19.1.13
8.5 P276 提示上方段落第一行 UserMinxin UserMixin 笔误 18.12.23
8.5.3 P279 代码清单 8-37 第 4 行 @login_required @login_required # 用于视图保护，后面会详细介绍 添加注释 19.1.5
8.7.2.1 P293 图8-16上面的提示段落 HTmL HTML 审校错误，大小写错误
P299 Flask-Avatars 版本 升级为 0.2.2 更新 19.3.5
9.1.1 P301 该页最后 1 行，电子书该节第 2 个代码块最后一行 向左缩进 4 格 排版错误 18.12.6
9.2 P304 图9-1左上角多了一个"搜索" 搜索 去掉一个搜索 笔误 18.12.10
9.2 P310 代码清单9-3代码块第7行 url_for ('main.index') url_for('main.index') 笔误 18.12.10
9.3.2.1 P312 第二个代码块上正文倒数第1行 Operations字典中 Operations类中 笔误 18.12.10
9.4.4 P324 代码清单9-14代码块第4-5行 两处均向左缩进 4 格 排版错误 18.12.10
P327 最后 1 个代码块上方文字 使用分号隔开 使用逗号隔开 错误 19.3.5
P330 代码清单 9-17 下面的段落第 2 行 Photo 模型和 User 模型 User 模型和 Photo 模型 优化 19.3.5
9.5.3 P334 9.6 小节上面的代码块 代码中的 400 和 800 分别替换为配置变量 current_app.config['ALBUMY_PHOTO_SIZE']['small'] 和 current_app.config['ALBUMY_PHOTO_SIZE']['medium'] 遗留代码 18.12.17
9.7.1 P339 代码清单 9-23 路径 macros.py macros.html 19.2.2
9.7.1 P340 代码清单9-24 上方 Photo_card() photo_card() 19.2.2
9.7.1 P340 代码清单9-24 导入语句第二行 form from 19.2.2
9.7.1 P340 代码清单 9-24 第 2 处注释 主要 主页 笔误 18.12.17
9.8.2 P360 代码清单9-41代码块上方正文倒数第3行 实际动作是有用户做出的 实际动作是由用户做出的 笔误 18.12.10
P364 倒数第 3 行 collections 模板 收藏页面模板 优化 19.3.5
9.9 P365 代码清单9-47下方的正文 timastamp timestamp 笔误 18.12.21
9.9.1 P365 9.9.1 标题下正文第一行 Uesr User 笔误 18.12.21
9.10.1 P379 代码清单9-59下面的代码块 第2行向右缩进1格，第3行向左缩进，和第2行对齐。 排版错误 18.11.18
9.13 - 9.13小节最后代码清单上面的文字 innit_app() init_app() 笔误 18.11.04
9.11.2 P388 提示下方的正文 Scripts块 scripts块 笔误 18.12.24
P393 代码清单 9-75 代码清单的文件路径和介绍中间添加缺失的中文引号 修正 19.3.5
P406 代码清单9-86 代码清单文件路径改为“albumy/templates/main/search.html” 错误 19.3.5
10.1 P417 项目结构示意图 blueprints下的__init__.py多缩进了 4 格 排版错误 18.12.27
10.2.2 P427 倒数第5行 ISO 639?1 ISO 639-1 笔误 18.12.28
10.2.4 P434 第 2 小节注意段落上方的正文段落的第一行 message.po messages.po 笔误 18.12.28
10.2.4 P436 图10-3下方的正文第二行 message.po messages.po 笔误 18.12.28
10.3.1 P442 倒数第5行 Simple Object Acsess Protocol Simple Object Access Protocol 笔误 18.12.28
10.3.3 P446-P447 目录结构示意图 v1包下的4个模块少缩进一级，且apis子包缺少__init__.py模块 排版错误 18.12.28
10.3.4 P454 第二段正文的第二行 Isssue Issue 笔误 18.12.28
10.2.5 P438 标题上面的附注文字 生成帮助信息 生成的帮助信息 审校错误。编辑以为自己在改病句，实际上却是在制造病句
10.3.1.4 P443 “10.3.2”小节上面段落倒数第3行 RSET REST 笔误
10.3.3.5 P453 代码清单10-13下面的提示段落最后1行 flask-restless Flask-Restless 大小写错误
P453 正文第二行 因为 API 的无状态特性，我们不能再使用 Flask-Login 实现认证功能 因为客户端不一定是浏览器，我们一般不会使用 Flask-Login 实现认证功能
P552 表 13-2 下面段落 第二句话结尾分号前追加括号文字“（可以使用 CACHE_DIR 配置变量指定缓存文件存储目录）”
11.1 P476 目录结构示意图 blueprints目录向左缩进一级 笔误 18.12.28
11.4.4 P507 正文第一行 ture true 笔误 18.12.29
12.3.2 P527 代码清单12-2第7行 test_app_exsit test_app_exist 拼写错误
12.3.2.2 P532 正文第4个段落的最后1行 JOSN JSON 笔误 19.01.05
12.3.2.3 P532 代码清单12-5 from sayhello.commands import forge from sayhello.commands import forge, initdb 导入缺失 19.01.05
12.3.3 P534 代码清单12-6第2个导入语句 from flask import current_app, url_for from flask import url_for 多余的导入 19.01.06
12.3.3 P534 代码清单12-7第2个导入语句 from flask import current_app, url_for from flask import url_for 多余的导入 19.01.06
12.3.3 P533 代码清单12-6上方正文最后第2行 tearDow() tearDown() 笔误 19.01.06
12.3.2.3 P532 代码清单 12-5 第一个注释 注释上面添加 1 个空行，注释前删除 1 个空格 排版错误 19.1.13
12.4.3 P540 代码清单12-10中test_index方法中self.assertIn()的第1个参数 'Todoism makes everything clear.' 'We are todoist, we use todoism.' 遗留代码未更新 19.01.06
12.6 P546 第1个附注段落上方的正文第2行 弃用 启用 笔误 19.01.06
13.3 P557 第2个提示段落 CND CDN 笔误 19.01.06
13.3.3 P560 第1段正文第3行 style块 styles块 笔误 19.01.06
14.3.1 P567 第二个代码块第2行 token_urlsafe(16) secrets.token_urlsafe(16) 笔误 18.11.28
14.3.4 P569 第一段正文下方的代码 app.logger.warning('A wraning message.') app.logger.warning('A warning message.') 笔误 19.01.21
14.3.4 P569 代码清单14-1 register_logger函数缺少app参数 register_logger() register_logging(app) 笔误 18.11.28
14.3.5 P572 代码块 wsgi.py 定义 导入语句补充 import os 19.2.2
14.4.2 P574 第2个提示段落上面两处 python(3) python3 审校错误
P578 第 1 个附注段落 GitHub的免费账户只能创建公开仓库，为此你可以考虑使用BitBucket（https://bitbucket.org），它提供不限数量的免费私有仓库。 GitHub（https://github.com） 和 BitBucket（https://bitbucket.org） 均支持免费创建私有仓库，你可以在创建仓库时进行选择。 更新 19.3.5
14.4.5 P579 下方正文 WGSI WSGI 笔误 19.01.21
15.5 P611 正文第3行 多一个句号 笔误 19.01.21
15.5.1 P611 倒数第2段正文第1行 laod() load() 笔误 19.01.21
15.5.1 P612 代码清单15-5中init_app()方法 static_folder='static , static_folder='static, 空格错误 19.01.21
15.5.1 P612 代码清单15-5中init_app()方法 倒数第2行去除一个多余的)符号 符号错误 19.01.21
P630 倒数第 2 行 “f” “f（红色背景）” 优化 19.3.5
16.4.1.1 P647 正文第1行 Ture True 笔误 19.01.21
16.4.1.2 P648 代码清单16-8中的注释 HTPP HTTP 笔误 19.01.21
16.4.3.3 P660 Cython交互代码片段第8第9行 代码与第6第7行重复，可删除 校对错误 19.1.7
16.4.5 P669 代码清单16-28 多行注释 一个字典，每当产生改变化时会调用传入的参数 一个字典，每当产生变化时会调用传入的参数 笔误 19.1.9
16.4.5 P672 第一段第一行 对传入的请求对象调用 set_cookie 对传入的响应对象调用 set_cookie 笔误 19.2.8

P7 附注段落，原文为：

附注 包括Flask在内，Flask的5个依赖包都由 Pocoo 团队（http://www.pocoo.org/）开发，主要作者均为Armin Ronacher（http://lucumr.pocoo.org/），这些项目均隶属于Pallets项目（https://www.palletsprojects.com/）。

修改为：

附注 包括Flask在内，Flask的5个依赖包都由 Pallets 团队（http://www.palletsprojects.com/）开发，主要作者均为 Armin Ronacher（http://lucumr.pocoo.org/），这些项目均隶属于Pallets Projects。

P181 代码清单6-1 第 9-13 行（以 MAIL 开头的那 6 行），去掉等号“=”两边的空格。

P214 代码清单 7-8 第 2 行修改，并新插入一行：

原文：

from sayhello import app
...

修改为：

from sayhello import app, db
from sayhello.models import Message
...

拼写错误，全书多处：Crtl 改为 Ctrl，下面是已知的错误位置：

  • P300 注意段落
  • P220 注意段落
  • P195 第二个注意段落
  • P416 注意段落
  • P475 注意段落
  • P15 正文第 1 行
  • P20 提示段落上面
  • P21 提示段落中两处
  • P577 页面中部两处
  • P580 页面中部
  • P584 页面中部
  • P633 第1行
  • P139 注意段落

关于URL长度限制的详情可以参考WWW FAQs: What is the maximum length of a URL?。

源码变动

目前所有的源码变动临时在 master 分支更新，后续会重写相应的标签。你可以访问对应项目的 GitHub 页面查看新增的 commit。

新变化提示

  • 第1章：PyCharm 2018.2版本增加了对Pipenv的支持。
  • 第1章：Pipenv自2018.6.25版本后在Windows中激活虚拟环境后会显示虚拟环境提示符。
  • 第 14 章：GitHub 免费账户已支持创建私有仓库。