Flask 快速入门

引言

Flask 是一个轻量级的Web框架，以简洁和灵活而著称。它提供了构建Web应用所需的基本工具，同时保持了足够的可扩展性，使其成为初学者和有经验的开发人员的首选。本系列专栏将带领大家逐步深入学习 Flask，从最基础的概念开始，逐步进阶至更高级的主题。

为什么选择 Flask

轻量级和简单： Flask 的设计理念是保持简单，使开发者能够专注于应用的逻辑而不被过多的框架代码干扰。
灵活性： Flask 是一个微框架，提供了基础的工具，但允许你根据项目的需要选择和集成其他库和工具。
易学易用： Flask 的文档清晰，社区活跃，对于初学者来说，是学习Web开发的绝佳选择。

前置准备：虚拟环境

虚拟环境是Python项目中推荐的一种良好实践，它使项目的依赖隔离开来。在终端中执行以下命令安装虚拟环境工具：

官方推荐：pipenv

pipenv 是一个用于 Python 项目的依赖管理工具，它结合了 pip、virtualenv 和 pyenv 的功能，提供了更简洁、一致的工作流。

安装 pipenv

pip install pipenv

创建虚拟环境并安装依赖

cd your_project_directory
pipenv install

这将会创建一个新的虚拟环境，并在项目根目录下生成 Pipfile 和 Pipfile.lock 文件。

如果你有一个 requirements.txt 文件，也可以使用以下命令：

pipenv install -r requirements.txt

进入虚拟环境

pipenv shell

终端提示符会变成虚拟环境的名称，表示已经在虚拟环境中。

安装新的依赖

pipenv install package_name

这将自动更新 Pipfile 文件，并将依赖项添加到 Pipfile.lock。

退出虚拟环境

exit

其他常用命令

# 查看虚拟环境中安装的包
pipenv graph# 卸载依赖
pipenv uninstall package_name# 查看虚拟环境路径
pipenv --venv# 查看 Python 解释器路径
pipenv --py# 检查安全性漏洞
pipenv check

使用 Pipfile 和 Pipfile.lock

Pipfile 文件用于指定项目的依赖关系，而 Pipfile.lock 文件用于确保项目的每次构建使用相同的依赖版本。这两个文件是配套使用的，Pipfile.lock 不需要手动编辑。

在团队合作时，你可以将 Pipfile 和 Pipfile.lock 文件一同提交到版本控制系统，确保每个人都使用相同的依赖环境。

Pipfile 示例：

[[source]]
url = "https://pypi.org/simple"
verify_ssl = true
name = "pypi"[dev-packages][packages]
requests = "*"
flask = "*"[requires]
python_version = "3.8"

Pipfile.lock 示例：

{"_meta": {"requires": {"python_version": "3.8"},"sources": [{"name": "pypi","url": "https://pypi.org/simple","verify_ssl": true}]},"default": {"flask": {"hashes": ["sha256:abc123..."],"version": "==1.0.2"},"requests": {"hashes": ["sha256:def456..."],"version": "==2.25.1"}}
}

pipenv 简化了 Python 项目的依赖管理，提供了一种更清晰和一致的方式来定义和安装依赖。

其他：venv

venv 是 Python 自带的用于创建虚拟环境的工具。

1. 创建虚拟环境

打开终端或命令提示符，然后移动到你项目的目录中。运行以下命令来创建一个名为 myenv 的虚拟环境：

python3 -m venv myenv

这将在当前目录下创建一个名为 myenv 的虚拟环境。

1. 激活虚拟环境

激活虚拟环境可以确保你在该环境中执行的 Python 脚本使用该虚拟环境的解释器和包。在终端中运行以下命令激活虚拟环境：

Windows:

myenv\Scripts\activate

Linux/Mac:

source myenv/bin/activate

激活后，你的命令提示符会显示虚拟环境的名称（例如，(myenv)），表示你当前在虚拟环境中。

1. 在虚拟环境中安装包

在虚拟环境中，你可以使用 pip 安装任何你需要的包，而这些包将仅对当前虚拟环境可见。

pip install package_name

1. 运行 Python 脚本

在虚拟环境中，你可以运行 Python 脚本，而这些脚本将使用虚拟环境中的 Python 解释器和安装的包。

python your_script.py

1. 退出虚拟环境

当你完成工作时，可以使用以下命令退出虚拟环境：

deactivate

注意事项：

虚拟环境的名称和目录结构是可以自定义的，上述命令中的 myenv 只是一个示例。
在虚拟环境中，你可以使用 pip freeze 命令生成 requirements.txt 文件，以便记录项目的依赖关系。
为了便于项目迁移，最好将虚拟环境放在项目目录之外，例如创建一个名为 venv 的目录，并将虚拟环境放在其中。

使用 venv 虚拟环境可以确保项目有独立的 Python 运行环境，防止包冲突和版本问题。

quick start

步骤 1: 创建 Flask 应用

创建一个新的目录，进入该目录，并在其中创建一个名为 app.py 的文件。

mkdir my_flask_app
cd my_flask_app
touch app.py

步骤 2: 安装 Flask

进入虚拟环境，然后安装flask

pip install flask

步骤 3: 编写第一个 Flask 应用

在 app.py 文件中编写以下代码：

from flask import Flaskapp = Flask(__name__)@app.route('/')
def hello():return 'Hello, Flask!'if __name__ == '__main__':app.run(debug=True)

步骤 4: 运行 Flask 应用

在终端运行应用：

python app.py

你将看到输出提示，表明 Flask 应用正在运行。在浏览器中访问 http://localhost:5000/，将看到 “Hello, Flask!”。

步骤 5: 使用模板引擎

Flask 使用 Jinja2 作为模板引擎。让我们添加一个简单的模板，以渲染 HTML 页面。

在 my_flask_app 目录中创建一个名为 templates 的文件夹。

mkdir templates

在 templates 文件夹中创建一个名为 index.html 的文件。

<!-- templates/index.html -->
<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Flask Template Example</title>
</head>
<body><h1>{{ greeting }}</h1>
</body>
</html>

更新 app.py 文件以使用模板。

from flask import Flask, render_templateapp = Flask(__name__)@app.route('/')
def hello():return render_template('index.html', greeting='Hello, Flask with Templates!')if __name__ == '__main__':app.run(debug=True)

现在，当访问 / 路由时，Flask 将渲染 index.html 模板，并将 greeting 变量传递给模板。

步骤 6: 接受用户输入

让我们添加一个简单的表单，允许用户输入名字。

更新 templates/index.html 文件。

<!-- templates/index.html -->
<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Flask Template Example</title>
</head>
<body><form method="post" action="{{ url_for('greet') }}"><label for="name">Enter your name:</label><input type="text" id="name" name="name" required><button type="submit">Greet</button></form>
</body>
</html>

更新 app.py 文件以处理表单提交。

from flask import Flask, render_template, request, redirect, url_forapp = Flask(__name__)@app.route('/')
def hello():return render_template('index.html')@app.route('/greet', methods=['POST'])
def greet():name = request.form.get('name', 'Guest')return f'Hello, {name}!'if __name__ == '__main__':app.run(debug=True)