使用 Flask 实现文件下载的完整指南
在现代的 Web 应用中，文件下载是非常常见的功能。Flask 作为一个轻量级的 Web 微框架，非常适合开发这样的功能。本文将详细介绍如何使用 Flask 实现文件下载的功能，包括详细步骤和代码示例。
文件下载的步骤
在开始之前，我们先梳理一下实现文件下载的整体流程：
| 步骤 | 描述 |
|---|---|
| 1 | 安装 Flask |
| 2 | 创建 Flask 应用 |
| 3 | 编写下载文件的视图函数 |
| 4 | 配置路由 |
| 5 | 启动 Flask 应用 |
以下是流程图，方便你理解整个过程：
flowchart TD
A[安装 Flask] --> B[创建 Flask 应用]
B --> C[编写下载文件的视图函数]
C --> D[配置路由]
D --> E[启动 Flask 应用]
接下来，我们将逐步深入每一个步骤。
第一步：安装 Flask
如果你还没有安装 Flask，可以使用 pip 来安装它。打开你的命令行工具，输入以下命令：
pip install Flask
这条命令将会从 Python 官方的包库中下载并安装 Flask。
第二步：创建 Flask 应用
现在我们可以开始创建一个简单的 Flask 应用。我们将会在一个 Python 文件中编写应用的代码。新建一个文件命名为 app.py，并在其中添加以下代码：
from flask import Flask
# 创建 Flask 应用实例
app = Flask(__name__)
代码解释：
from flask import Flask：从 Flask 模块中导入 Flask 类。app = Flask(__name__)：创建一个 Flask 应用实例，__name__是当前模块的名称，用于确定应用的位置。
第三步：编写下载文件的视图函数
现在我们需要编写一个视图函数来处理文件下载。下面的代码将返回一个现有文件的下载：
from flask import send_from_directory
# 下载文件的视图函数
@app.route('/download/<filename>')
def download_file(filename):
return send_from_directory(directory='files', path=filename, as_attachment=True)
代码解释：
@app.route('/download/<filename>')：定义一个路由，这个路由包含了文件名参数。send_from_directory(directory='files', path=filename, as_attachment=True)：将指定目录files中的文件（以参数filename传入）返回给用户，并作为附件下载。
创建文件目录
确保你有一个名为 files 的目录，并且其中包含你想要下载的文件。例如，你可以在项目根目录下创建一个 files 文件夹，并在其中放置一些测试文件。
第四步：配置路由
路由在 Flask 中用于将 HTTP 请求映射到 Python 函数。我们在前面的代码中已经配置了一个简单的路由，即 /download/<filename>。这个路由会把任何请求，比如 /download/testfile.txt，映射到 download_file 函数中。
第五步：启动 Flask 应用
现在，我们只需启动 Flask 应用，就可以开始测试下载功能。继续在 app.py 文件中添加以下代码：
if __name__ == '__main__':
app.run(debug=True)
代码解释：
if __name__ == '__main__':：该语句确保该代码只能在直接运行该文件时执行。app.run(debug=True)：启动 Flask 应用，debug=True模式会让你在开发过程中看到重要的错误信息，并能实现热加载。
完整代码示例
综上所述，app.py 的完整代码如下：
from flask import Flask, send_from_directory
# 创建 Flask 应用实例
app = Flask(__name__)
# 下载文件的视图函数
@app.route('/download/<filename>')
def download_file(filename):
return send_from_directory(directory='files', path=filename, as_attachment=True)
# 启动 Flask 应用
if __name__ == '__main__':
app.run(debug=True)
测试文件下载功能
现在一切都准备好了，打开你的命令行工具，导航到你的项目目录并运行以下命令：
python app.py
如果一切正常，你将看到 Flask 应用在localhost上的默认端口（通常是5000）启动。打开浏览器，访问以下链接进行测试：
http://localhost:5000/download/yourfile.txt
这里的 yourfile.txt 是你在 files 文件夹中放置的文件名。访问这个 URL 时，浏览器会自动开始下载该文件。
结论
恭喜你！你已经成功实现了使用 Flask 进行文件下载的功能。本文详细介绍了每一步的具体实现，并附上了完整的代码示例。希望你能在自己的项目中灵活运用这一功能。随着你对 Flask 了解的加深，你还可以扩展这个项目，加入更多的功能，比如用户认证或文件上传等。继续加油，开发之路会更加精彩！
