Django应用无法从<script>读取静态cart.js文件，请求协助排查

问题描述 #

我刚接触Django，已查阅相关解决方案但仍无法解决问题：我的Django应用无法从base.html模板中读取并加载cart.js文件。我已反复检查settings.py配置、文件结构、主urls.py等，但未找到问题根源。附上settings.py、base.html、静态文件结构、主urls.py的截图，以及模板渲染报错截图。我猜测问题出在静态文件设置中，但无法定位具体位置，恳请帮助。

排查与解决步骤 #

• 验证settings.py静态配置

  • 开发环境下确保DEBUG = True，生产环境需配置STATIC_ROOT并执行python manage.py collectstatic
  • 确认INSTALLED_APPS包含'django.contrib.staticfiles'
  • 检查STATIC_URL是否设为'/static/'（或你自定义的路径）
  • 若使用自定义静态目录，STATICFILES_DIRS需正确指向路径，示例：

    STATICFILES_DIRS = [
        BASE_DIR / "static",
    ]
    

• 检查模板引用语法

  • 模板开头必须加载静态标签：{% load static %}
  • 确认js文件引用路径与实际文件位置匹配，示例：

    <!-- 若cart.js在static/js/cart.js -->
    <script src="{% static 'js/cart.js' %}"></script>
    

    注意：如果cart.js放在某个app的static/app_name/cart.js下，路径要写成'app_name/cart.js'

• 核对文件实际位置

  • 确认cart.js确实存在于STATICFILES_DIRS指定的目录，或对应app的static子目录中

• 验证urls.py路由配置

  • 主urls.py需添加静态文件路由（仅开发环境需要）：

    from django.conf import settings
    from django.conf.urls.static import static
    
    urlpatterns = [
        # 你的其他路由配置
    ] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
    

• 排除缓存问题

  • 用浏览器硬刷新（Ctrl+F5）清除缓存，或直接访问静态文件URL（如http://localhost:8000/static/js/cart.js），若无法访问则说明路径配置错误；若能访问则检查模板引用路径

内容的提问来源于stack exchange，提问作者Dave Roberts