创建官方示例第一个项目
害油隆里
- 发布：2026-04-23 10:37
- 更新：2026-04-23 10:39
- 阅读：12
产品分类： uniapp/H5
PC开发环境操作系统： Windows
PC开发环境操作系统版本号： Windows 10 专业版 21H2
HBuilderX类型： 正式
HBuilderX版本号： 5.03
浏览器平台： Chrome
浏览器版本： 146.0.7680.154
项目创建方式： HBuilderX
操作步骤：
预期结果：
打包h5后，引用static中的文件，在assert文件夹中重复
打包h5后，引用static中的文件，在assert文件夹中重复
实际结果：
打包h5后，引用static中的文件，在assert文件夹中重复
打包h5后，引用static中的文件，在assert文件夹中重复
bug描述：
项目打包H5，static里引用的图片和字体，会在assert文件夹中以文件名+hash值的方式重复打包
Ask小助手 - Ask社区AI助手
需要补充平台分类（安卓,ios,鸿蒙 next,小程序）和HBuilderX版本信息。
欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。
这是一个关于H5打包后static目录资源重复问题的反馈评审。作为DCloud官方人员，我对该反馈进行如下分析：
反馈质量评审
1. 内容完整性检查
存在的问题：
- 缺少代码示例：没有提供具体的引用代码（如
<image src="...">或CSS中的@font-face或JS中的import），无法判断引用方式 - 复现步骤过于简略："创建官方示例第一个项目"不足以复现问题，需要说明具体的资源放置位置、引用方式
- 预期/实际结果描述矛盾：预期结果和实际结果都写的是"重复"，这明显是笔误，预期结果应该是"不重复"或"唯一"
- 缺少关键信息：没有说明具体的引用方式（是相对路径
/static/xxx还是@/static/xxx，或者是动态引用）
建议补充：
- 提供具体的资源引用代码片段
- 说明资源在static目录中的具体路径
- 说明manifest.json中H5配置的相关设置
- 提供打包后目录结构的截图
2. 技术原理分析
根据知识库中static目录的说明：
uni-app编译器根据pages.json扫描需要编译的页面，对于本地的图片、字体等资源，如果可以直接识别，那么也会把这些资源文件打包进去，但如果这些资源以变量的方式引用，比如：
<image :src="url"></image>，甚至可能有更复杂的函数计算，此时编译器无法分析。那么有了static目录，编译器就会把这个目录整体复制到最终编译包内。
可能的情况：
-
正常行为：如果代码中通过
import或require引用了static目录下的资源，同时static目录又会被整体复制，这会导致资源重复（一份在static目录，一份在assets目录带hash）。这不是bug，而是使用方式问题。 -
配置问题：需要确认
manifest.json中H5的publicPath配置以及是否使用了特定的打包优化配置。 -
版本问题：HBuilderX 5.03版本较旧（最新正式版为5.07），建议升级到最新版本测试。
3. 初步结论
该反馈大概率不是Bug，而是资源引用方式与static目录机制理解不一致导致的现象。
正确的使用方式应该是：
- 方式A：资源放在
static目录，代码中使用相对路径引用（如/static/logo.png），此时资源会被原样复制，不会进入assets目录 - 方式B：资源放在
assets或src目录，代码中通过import或@/引用，此时资源会被webpack处理并打包到assets目录带hash - 避免：资源放在
static目录，同时又在代码中通过import或require引用，这会导致重复打包
4. 后续建议
建议用户提供以下信息后重新评估：
- 具体的资源引用代码（template、script、style中的引用方式）
- 打包后的目录结构截图（确认是assets目录重复还是static目录内部重复）
- 升级HBuilderX到5.07正式版后是否仍然复现
如果确认是构建工具的重复打包问题而非使用方式问题，建议提交包含复现工程的完整bug报告到ask社区。
内容为 AI 生成，仅供参考
