Webpack构建产物需通过STATICFILES_DIRS引入Django，配合django-webpack-loader动态注入带hash的资源路径，并在开发时用publicPath代理实现热更新，生产环境须先构建再collectstatic。
Webpack 构建产物怎么让 Django 找得到
Django 默认只从 STATICFILES_DIRS 和各 app 的 static/ 目录收集静态文件，而 Webpack 输出的 dist/ 或 build/ 是独立路径，不自动纳入管理。直接把构建结果扔进 static/ 会导致 Git 冲突、重复拷贝、哈希文件名失效等问题。
- 把 Webpack 输出目录（如
./dist）加进STATICFILES_DIRS，但要确保它在manage.py collectstatic时被扫描到 - 在
settings.py中配置：STATICFILES_DIRS = [ BASE_DIR / "static", BASE_DIR / "dist", # ← 这里是 Webpack 输出目录 ] - 必须确认
dist/是相对manage.py所在位置的路径；如果 Webpack 配置了output.path: path.resolve(__dirname, '../staticfiles')，那就该把staticfiles加入STATICFILES_DIRS - 别用符号链接代替路径添加——
collectstatic不解析 symlink，会跳过
如何避免 Django 模板里硬编码 JS/CSS 路径
Webpack 开启 contenthash 后，JS 文件名带哈希（如 main.a1b2c3.js），每次构建都变。Django 模板里写死 <script src="/static/main.js"> 就会 404。
- 用
django-webpack-loader插件，它读取 Webpack 生成的webpack-stats.json，动态替换模板中的资源路径 - 安装后，在
settings.py中配好：WEBPACK_LOADER = { 'DEFAULT': { 'STATS_FILE': BASE_DIR / 'webpack-stats.json', } } - 模板中改用：
{% load render_bundle from webpack_loader %} {% render_bundle 'main' %}，它会自动插入mainchunk 对应的 JS + CSS - 确保 Webpack 配置里开了
stats: { assets: true }，且插件能读到真实路径（开发时用webpack-dev-server需额外配publicPath）
开发时 Webpack Dev Server 和 Django 开发服务器怎么共存
两个服务默认都跑 localhost:8000，端口冲突；更关键的是，Django 模板里引用的 /static/xxx.js 在开发时其实该走 Webpack 的内存文件系统（不是磁盘上的 dist/），否则看不到热更新。
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
- 让 Webpack Dev Server 跑在
localhost:3000，Django 继续用8000，然后用代理把/static/请求转发过去 - 在 Webpack 配置的
devServer.proxy里加：proxy: { '/static/': { target: 'http://localhost:8000', changeOrigin: true, } }——不对，这是反向；正确做法是 Django 模板里让静态资源走http://localhost:3000/static/，所以得配 Webpack 的publicPath: 'http://localhost:3000/static/' - 同时在
settings.py里临时改STATIC_URL = 'http://localhost:3000/static/'（仅 DEBUG=True 时），这样render_bundle输出的 script 标签 URL 才对 - 别忘了关掉 Django 的
DEBUG=False下的静态文件服务，否则本地调试时容易混淆来源
生产环境部署时 collectstatic 和 Webpack 构建顺序很重要
collectstatic 会清空 STATIC_ROOT 并复制所有 STATICFILES_DIRS 下的文件。如果 Webpack 还没运行，dist/ 为空，那上线后页面就缺 JS。
立即学习“Python免费学习笔记（深入）”；
- CI/CD 流水线里，必须保证 Webpack 构建完成、输出稳定后再执行
python manage.py collectstatic --noinput - 不要在
STATIC_ROOT里直接跑 Webpack —— 它可能被collectstatic清掉，或权限出问题 - 如果用了
django-webpack-loader，记得把webpack-stats.json也放进STATICFILES_DIRS或单独 copy 到可读位置，不然线上找不到 stats 文件会报错Stats file not found: /path/to/webpack-stats.json - 检查
webpack-stats.json里的路径是否为相对路径；如果是绝对路径（如/static/main.js），而你又配了 CDN 域名，就得用WEBPACK_LOADER['DEFAULT']['PUBLIC_PATH']覆盖
最常漏掉的是：Webpack 的 output.publicPath 和 Django 的 STATIC_URL 在开发/生产环境语义不一致，一个管浏览器请求路径，一个管后端拼接逻辑，混用就会 404。调的时候先看 Network 面板里实际请求的是哪个 URL，再反推哪一层配错了。
