Flask默认静态文件路径为static/，必须与app.py同级且全小写无下划线；url_for('static', filename=...)中filename为static目录内相对路径，不支持绝对路径或../跳转；可配置static_folder指定其他路径。
Flask 默认静态文件路径是 static/，不是 _static
Flask 会自动把项目根目录下的 static 文件夹当作静态资源服务根目录。你如果建了 _static 或 assets 这类名字，Flask 完全不认——它不会扫描、不会挂载、也不会报错，只是静默忽略。
常见错误现象：url_for('static', filename='css/app.css') 返回 /static/css/app.css，但浏览器 404；检查后发现文件实际放在 _static/css/app.css。
- 必须用
static（全小写，无下划线）作为文件夹名 - 该文件夹必须与
app.py（或创建Flask实例的主模块）在同一级目录 - 不支持嵌套多层查找，比如
src/static不会被识别，除非显式配置static_folder
url_for('static', filename=...) 的 filename 是相对 static/ 的路径
这个参数不是完整路径，也不是 URL 路径，而是从 static 文件夹内部开始算的相对路径。它不接受以 / 开头的写法，否则会拼出错误 URL（如 /static//css/app.css）。
使用场景：在模板里引用 JS/CSS/图片，或后端生成静态资源链接。
- ✅ 正确：
url_for('static', filename='js/main.js')→/static/js/main.js - ❌ 错误：
url_for('static', filename='/js/main.js')→ 多余斜杠，可能触发 404 - ❌ 错误：
url_for('static', filename='../templates/base.html')→ 超出static目录，被 Flask 拒绝（安全限制） - 注意：路径分隔符统一用
/，Windows 下也不要用\
想换静态文件夹位置？别改名，改 static_folder 参数
硬改文件夹名为 _static 是最常见也最没必要的操作。Flask 允许你在创建应用时指定真实路径，既保持习惯命名，又不破坏机制。
性能 / 兼容性影响：无额外开销，static_folder 是初始化时解析的字符串路径，不影响运行时性能。
- 示例：
app = Flask(__name__, static_folder='src/static')，此时static/文件夹可删掉，Flask 只认src/static - 也可以用绝对路径：
static_folder='/var/www/myapp/assets' - 如果同时改了
static_url_path（比如设为'/assets'），那么url_for('static', ...)生成的 URL 前缀就变成/assets/...，但文件仍从static_folder读取
开发时静态文件 404，先确认三件事
不是所有 404 都是路径问题。尤其在调试阶段，容易卡在看似无关的环节。
- 检查
app.run()是否启用了debug=True—— 关闭 debug 时，Flask 不自动提供静态文件服务（需 WSGI 服务器或手动配置） - 确认文件权限：Linux/macOS 下，如果
static/或其子文件不可读（chmod -R a+r static），会返回 404 而非 403 - 模板中是否漏写了
url_for？直接写死/static/xxx在部署到子路径（如 Nginx 配置了location /myapp/）时必然失效
真正麻烦的是混合部署场景：Nginx 做了前缀重写，但 url_for 还按根路径生成，这时候得配 APPLICATION_ROOT 或用 FORCE_SCRIPT_NAME，而不是去动 static 文件夹名字。
