前言
2023-8-11
以前对网站开发萌生了想法，又有些急于求成，在B站照着视频敲了一个基于flask的博客系统。但对于程序的代码难免有些囫囵吞枣，存在许多模糊或不太理解的地方，只会照葫芦画瓢。
而当自己想开发一个什么网站的时，就如同摸着石头过河，常在许多小问题上卡住，不知怎么实现，也不知道需要去学习什么才能实现。例如，要做一个聊天室程序，我却不知道在一方发出消息时，如何在另一方实时地显示出来，思虑许久而终归于放弃。
学习系统且详细的知识有其好处，它可以冲退我那种徒手在黑暗中摸索的感觉。读了“狼书”的两个章节，自觉很有收获，此前的许多疑惑也得到了解答。然凡事各有弊益，啃书不是易事，还需下苦功夫。
曾有人对我说，看视频会更有效率。也许他是对的？但我好像更喜欢书籍给我的感觉。但有些讽刺的是，大学至今，我却也没看下来多少书，而时间在我休息的时候，它仍努力奔跑，两载一晃而过。而不少人，也是这相似的困境吧？
回到本文，它是一篇读书笔记，参杂少许个人想法但含量不高，所记零散，主要是作为个人提纲备忘，或许对诸位而言阅读价值不高。若想学习 Flask 框架，我还是很推荐去读“狼书”原著的。
开始
5个难度递增的案例：留言板SayHello，个人博客Bluelog，图片社交网站Albumy，待办事项程序Todoism，聊天室CatChat。
前端学习：
Web很多程序离不开javascript，它可以方便、简洁地实现很多页面按逻辑和功能。
了解Git：https://try.github.io/
文本编辑器：
作者的博客：http://greyli.com
Git使用
克隆本书代码仓库：
git clone https://github.com/greyli/helloflask.git
查看当前项目仓库中包含的所有标签：
git tag -n
签出对应标签版本的代码：
git checkout foo
签出前对文件做了修改，需要撤销：
git reset --hard
使用diff命令比较两个标签对应版本之间的变化：
git diff foo bar
使用git客户端直观查看版本变化：
gitk
定期使用git fetch命令来更新本地仓库：
git fetch --all git fetch --tags git reset --hard origin/master
在本地复制新的派生仓库，后可以在本地自由修改其中的代码：
git clone https://github.com/你的用户名/helloflask.git
1 初识Flask
Web框架可以让我们不用关心底层的请求响应处理，更方便地编写Web程序。
两个主要依赖：（p3）
- WSGI（Web Server Gateway Interface，Web服务器网关接口）的工具集——Werkzeug（http://werkzeug.pocoo.org/）
- Jinja2模板引擎
1.1 搭建开发环境
Pipenv：pip的加强版，让包安装、包依赖管理、虚拟环境管理更加方便。
创建虚拟环境：在项目根目录（即helloflask文件夹中），使用pipenv install命令。Pipfile文件列出的依赖包也会一并被安装。
显示激活虚拟环境：Pipenv会自动从项目目录下的.env文件中加载环境变量。
# 激活 pipenv shell # 退出 exit
临时使用虚拟环境中的python解释器：（更推荐）
pipenv run python hello.py
查看当前环境下的依赖情况：
pipenv graph
关于Pipfile项目的更多情况，请访问其主页。
使用pipenv install命令安装包时，都是安装到虚拟环境中。相当于使用pip在激活虚拟环境的情况下安装包。
更新flask版本：(书中为flask-1.0.2)
pipenv update flask
集成开发环境：pycharm专业版提供了更多针对Flask开发的功能，比如创建Flask项目模板，Jinja2语法高亮，与Flask命令行功能集成等。
设置Python解释器（好像已经不需要了）：因为PyCharm未集成支持Pipenv。（p10）
1.2 简单示例
from flask import Flask app = Flask(__name__) @app.route('/') def index(): return '<h1>Hello Flask!</h1>'
Flask类表示一个Flask程序，实例化这个类就得到了我们的程序实例app。__name__对于文件app.py而言，值即为“app”，它帮助Flask在相应的文件夹里找到需要的资源，比如模板和静态文件。（p12）
注册路由：路由负责管理URL和函数之间的映射。
- 一个视图函数可以绑定多个路由。
- 动态路由：可以传递参数，并可设置默认参数。
注：Flask内置一个开发服务器，但在实际生产环境中需要使用性能更好的生产服务器。
启动开发服务器：
# 未启动虚拟环境下使用 pipenv run flask run # 在虚拟环境中 flask run # 命令未找到 python -m flask run
app.run()方法也可启动开发服务器，已经不推荐使用。
flask寻找程序实例：
- 在当前目录下，名为
app.py或wsgi.py的文件中寻找名为app的程序实例。 - 根据环境变量FLASK_APP寻找。
# 在linux $ export FLASK_APP=hello # 在windows > set FLASK_APP=hello
管理环境变量：使用python-dotenv包，从.env或.flaskenv文件加载。其中.env文件存放一些敏感数据。
pipenv install python-dotenv
可在.flaskenv写入：
# 默认为production(生产环境)，开发模式将打开调试器和重载器。 FLASK_ENV=development
使用Pycharm的运行配置（而不使用命令行）：在Run --> Edit Configurations（p19）
使服务器外部可见：让局域网用户可以通过你的内网IP进行访问。想要公网访问，可以考虑内网穿透工具、端口转发工具等，如 ngrok、Localtunnel。
flask run --host=0.0.0.0
flask的环境变量：可通过FLASK__设置各种选项。
重载器：安装 Watchdog。Werkzeug内置有stat重载器，但耗电严重且准确性一般。
# dev: 开发依赖的包 pipenv install watchdog --dev
打开PythonShell：使用flask打开的shell自动包含程序上下文，并且已经导入了app实例。
flask shell
Flask扩展：使用Flask提供的接口编写的Python库。扩展可以加速开发，但也会降低灵活性，并可能存在bug。
Flask项目配置：可能用到Flask提供的配置、扩展提供的、程序特定的配置。它们用Flask对象的app.config属性作为统一的接口。
- Flask配置章节：https://flask.pocoo.org/docs/latest/config/
app.config['ADMIN_NAME'] = 'Peter' # 一次加载多个值 app.config.update()方法
URL：使用url_for()，方便url规则的修改。
- 相对url与绝对url（p24）
Flask狼书笔记 | 01_初识Flask，02_Flask与HTTP(2)：https://developer.aliyun.com/article/1407209?spm=a2c6h.13148508.setting.20.79f64f0ecKMDuK
