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
<!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
# 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
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
Otras extensionesEl 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.