Flask 框架（一）：核心特性与基础配置-EW帮帮网

from flask import Flask

app = Flask(
    import_name=__name__,  # 必传，通常为__name__，决定静态文件路径
    static_url_path='/static',  # 静态文件访问URL前缀，默认'/static'
    static_folder='static',  # 静态文件存储目录，默认'static'
    template_folder='templates'  # 模板文件存储目录，默认'templates'
)

参数说明：

import_name：用于定位项目根目录，传入__name__即可满足绝大多数场景。
静态文件访问规则：默认通过http://域名/static/文件名访问，修改static_url_path或static_folder后需对应调整路径。

示例：若将静态目录改为assets，访问路径需改为/static/文件名（static_url_path默认值），但实际文件存储在assets文件夹中。

2.2 运行配置：app.run () 参数详解

创建实例后，通过app.run()启动服务，常用参数如下：

app.run(
    host="0.0.0.0",  # 允许外部访问（默认仅本地127.0.0.1）
    port=5000,  # 端口号，默认5000
    debug=True  # 调试模式开关
)

其中，debug=True（调试模式）是开发阶段的 “利器”，开启后：

代码修改后自动重启服务，无需手动重启
错误发生时，前端直接显示详细堆栈信息（生产环境必须关闭，避免泄露敏感信息）

2.3 应用配置：三种参数设置方式

Flask 的配置参数（如数据库地址、密钥等）可通过多种方式设置，适用于不同场景：

1. 字典直接配置（简单临时场景）

直接通过app.config字典修改，适合快速测试：

app.config['DEBUG'] = True  # 开启调试模式
app.config['SECRET_KEY'] = 'dev_key'  # 会话加密密钥（开发环境临时值）

2. 配置文件导入（生产级安全）

将配置写入独立文件（如config.py），通过from_pyfile导入，避免敏感信息硬编码：

# config.py
DEBUG = False
SECRET_KEY = 'your_secure_key'
SQLALCHEMY_DATABASE_URI = 'mysql://user:pass@localhost/db'

# 应用中导入
app.config.from_pyfile('config.py')

3. 类继承配置（复杂项目首选）

通过类定义配置，支持继承与环境区分（如开发 / 生产环境）：

class BaseConfig:
    SECRET_KEY = 'shared_key'
    SQLALCHEMY_TRACK_MODIFICATIONS = False

class DevConfig(BaseConfig):
    DEBUG = True
    SQLALCHEMY_DATABASE_URI = 'mysql://root:dev_pass@localhost/dev_db'

class ProdConfig(BaseConfig):
    DEBUG = False
    SQLALCHEMY_DATABASE_URI = 'mysql://user:prod_pass@localhost/prod_db'

# 根据环境选择配置
app.config.from_object(DevConfig)  # 开发环境
# app.config.from_object(ProdConfig)  # 生产环境

三、路由与视图：Flask 的核心交互逻辑

路由与视图是 Flask 处理用户请求的核心机制：路由定义 URL 规则，视图函数处理业务逻辑并返回响应。

3.1 基础路由定义

通过@app.route装饰器定义路由，语法简洁直观：

@app.route('/')  # 根路径
def index():
    return 'Hello, Flask!'  # 返回字符串响应

指定 HTTP 方法：默认仅支持GET，通过methods参数扩展：

@app.route('/login', methods=['GET', 'POST'])
def login():
    if request.method == 'GET':
        return '登录页面'
    else:
        return '处理登录请求'

查看项目路由：通过flask routes命令或代码遍历查看所有路由：

for rule in app.url_map.iter_rules():
    print(f"URL: {rule.rule}, 方法: {rule.methods}, 视图: {rule.endpoint}")

3.2 路由高级特性

动态参数传递

支持在 URL 中嵌入参数（如用户 ID），并指定类型（int/float/string）：

@app.route('/user/<int:user_id>')  # 仅匹配整数ID
def user_detail(user_id):
    return f"用户ID: {user_id}"  # 参数直接传入视图函数

路由反向解析

使用url_for根据视图函数名生成 URL，避免硬编码路径（尤其适合动态路由）：

from flask import url_for, redirect

@app.route('/profile')
def profile():
    return '个人主页'

@app.route('/redirect-to-profile')
def redirect_demo():
    # 反向解析profile视图的URL（此处为'/profile'）
    profile_url = url_for('profile')
    return redirect(profile_url)  # 重定向到个人主页

四、请求与响应：数据交互基础

Flask 通过request对象获取客户端数据，通过多种方式返回响应，满足不同场景需求。

4.1 获取请求数据

request对象封装了 HTTP 请求细节，需从flask导入：

from flask import request

@app.route('/submit', methods=['GET', 'POST'])
def submit():
    # 获取GET参数（?name=xxx&age=18）
    name = request.args.get('name', '匿名')  # 第二个参数为默认值
    
    # 获取POST表单数据（Content-Type: application/x-www-form-urlencoded）
    if request.method == 'POST':
        email = request.form.get('email')
    
    # 获取JSON数据（Content-Type: application/json）
    json_data = request.get_json()  # 解析JSON为字典
    
    return f"Hello, {name}!"

4.2 构建响应内容

Flask 支持多种响应类型，覆盖常见 Web 场景：

字符串响应：直接返回文本（默认text/html类型）
```
return '简单文本'
```

模板渲染：通过render_template返回 HTML 页面（需配合templates目录）：

from flask import render_template

@app.route('/page')
def show_page():
    # 传递变量到模板（templates/page.html）
    return render_template('page.html', title='Flask页面', content='欢迎访问')

JSON 响应：通过jsonify返回 JSON 数据（自动设置Content-Type:application/json）：

from flask import jsonify

@app.route('/api/data')
def api_data():
    return jsonify(code=200, message='success', data={'key': 'value'})

重定向：通过redirect跳转到其他 URL：

from flask import redirect
return redirect('/login')  # 重定向到登录页
return redirect(url_for('index'))  # 结合反向解析更灵活

自定义响应：通过make_response设置状态码、响应头：

from flask import make_response

@app.route('/custom')
def custom_response():
    resp = make_response('自定义响应')
    resp.status_code = 201  # 状态码（默认200）
    resp.headers['X-Custom-Header'] = 'flask'  # 自定义响应头
    return resp

小结

本文介绍了 Flask 的核心特性、基础配置、路由视图与数据交互逻辑，覆盖了搭建简单 Web 应用的全部基础。Flask 的设计哲学是 “简约而不简单”—— 看似轻量的框架，却能通过扩展灵活支撑复杂项目。

下一篇将深入讲解 Flask 的高级特性，包括会话管理、模板引擎、数据库交互、表单处理等实战必备技能，帮助你从 “能运行” 提升到 “能落地”。

Flask 框架（一）：核心特性与基础配置

一、为什么选择 Flask？

二、Flask 核心概念与初始化

2.1 程序实例初始化