Archivos estáticos de Flask

Cualquier aplicación web completa no puede prescindir de recursos estáticos como CSS, JavaScript e imágenes.

Este capítulo presenta cómo Flask gestiona y sirve archivos estáticos.


Convención de archivos estáticos predeterminada

Por defecto, Flask, desde el directorio de la aplicaciónstatic/La carpeta proporciona archivos estáticos.

Solo necesitas crear esta carpeta y colocar los recursos estáticos dentro:

myflaskapp/
├── app.py
├── templates/
│   └── index.html
└── static/
    ├── css/
    │   └── style.css          # 样式文件
    ├── js/
    │   └── main.js            # JavaScript 文件
    └── images/
        └── logo.png           # 图片文件

Referenciar archivos estáticos en plantillas

No codifiques la ruta de forma fija, utilizaurl_for('static', filename='...')para generar la URL del archivo estático.

La ventaja de hacerlo así es que, incluso si en el futuro la aplicación se monta en una subruta (como/myapp), la URL también se ajustará automáticamente.

Ejemplo

<!-- Ruta del archivo: templates/index.html -->
<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>Tutorial de Flask de EJEMPLO</title>
    <!-- Referenciar archivo CSS -->
    <link rel="stylesheet" href="{{ url_for('static', filename='css/style.css') }}">

    <!-- Favicon del sitio web -->
    <link rel="icon" href="{{ url_for('static', filename='images/favicon.ico') }}">
</head>
<body>
    <!-- Referenciar imagen -->
    <img src="{{ url_for('static', filename='images/logo.png') }}" alt="EJEMPLO Logo" width="200">

    <h1>Bienvenido a EJEMPLO</h1>
    <p>Esta es una aplicación web construida con Flask.</p>

    <!-- Referenciar archivo JavaScript -->
    <script src="{{ url_for('static', filename='js/main.js') }}"></script>
</body>
</html>

Personalizar la ruta de archivos estáticos

Si no quieres usar lastatic/carpeta predeterminada, puedes personalizarla al crear la aplicación Flask:

Ejemplo

from flask import Flask

# static_folder: ruta de la carpeta en el servidor
# static_url_path: ruta de acceso en la URL
app = Flask(__name__,
           static_folder="public",        # Los archivos estáticos se colocan en el directorio public/
           static_url_path="/assets")     # Se accede a través de la ruta /assets
# En este caso, acceder a /assets/css/style.css corresponde al archivo public/css/style.css
Parámetro Valor predeterminado Descripción
static_folder "static" Carpeta local para almacenar archivos estáticos
static_url_path None (utiliza el nombre de static_folder) Prefijo de URL expuesto para los archivos estáticos

Ejemplo de archivo CSS

Crea un archivo de estilos básico para que la página se vea más profesional:

Ejemplo

/* Ruta del archivo: static/css/style.css */
body {
    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
    max-width: 800px;
    margin: 0 auto;
    padding: 20px;
    line-height: 1.6;
    color: #333;
}

h1 {
    color: #2c3e50;
    border-bottom: 2px solid #3498db;
    padding-bottom: 10px;
}

nav {
    background: #f8f9fa;
    padding: 10px;
    border-radius: 4px;
    margin-bottom: 20px;
}

nav a {
    color: #3498db;
    text-decoration: none;
    margin-right: 15px;
}

footer {
    margin-top: 40px;
    padding-top: 20px;
    border-top: 1px solid #eee;
    color: #999;
    font-size: 14px;
}

Accede ahttp://127.0.0.1:5000/, el resultado es el siguiente:


Diferencias entre el entorno de desarrollo y el de producción

El servicio de archivos estáticos integrado en Flask solo es adecuado para elentorno de desarrollo。

En el entorno de producción, servidores web profesionales como Nginx o Apache deberían manejar directamente los archivos estáticos, ya que esto es mucho más eficiente que servirlos mediante código Python.

Los detalles del despliegue en producción se explicarán en capítulos posteriores.

Otras extensiones