HTML5不支持用注释声明模块依赖，真实依赖只能通过<script type="module">中的import语句、importmap或构建配置体现；HTML注释仅可作人工说明，不可靠且无执行效力。
HTML5 里没法用注释声明模块依赖
HTML5 标准不支持、也不定义任何用于表达“模块依赖关系”的注释语法。像 <!-- @requires module-a --> 或 <!-- depends on: utils.js --> 这类写法，浏览器完全忽略，构建工具（如 Webpack、Vite）也默认不识别——除非你额外配置自定义插件解析 HTML 注释，但这属于非常规操作，且不可靠。
真正起作用的依赖声明只在 script 标签里
模块依赖必须通过执行时的加载机制体现，而不是注释。现代前端依赖关系由以下方式实际建立：
-
<script type="module">中的import语句才是真实依赖声明，例如：import { debounce } from './utils.js'; -
<script type="module" src="main.js"></script>的src文件内部若有import，其依赖链由浏览器/打包器自动解析 - 使用
importmap时，映射关系写在<script type="importmap">中，不是注释{"imports": {"lodash": "/node_modules/lodash-es/index.js"}}
注释里写依赖说明只适合人工维护场景
如果你坚持要在 HTML 里加依赖提示（比如给团队成员看），只能作为非执行性说明，且需统一约定格式，例如：
- 用固定前缀提高可读性：
<!-- DEPS: ./lib/chart.js, ./utils/validation.js --> - 避免和构建工具冲突：不要用
@require、@depends等可能被其他工具捕获的 JSDoc 风格 - 注意位置：放在对应
<script>标签上方，而非整个<head>顶部，否则易失效 - 别指望它能触发加载或校验——它只是给人看的，CI 或 IDE 不会检查它是否过期
更可靠的做法是把依赖关系外移到配置或代码中
靠注释维护依赖信息，出错率高、同步成本大。实际项目中应优先选择：
立即学习“前端免费学习笔记（深入）”；
- ESM
import语句（最标准、可静态分析、支持 tree-shaking） - 构建配置文件（如
vite.config.js中的optimizeDeps.include） - 显式初始化逻辑（例如在
app.js开头写await import('./features/reporting.js')） - 如果必须文档化，用单独的
ARCHITECTURE.md或模块 README，而非混在 HTML 注释里
HTML 注释不是依赖管理系统，把它当便利贴用可以，但千万别当契约。依赖关系一旦脱离执行路径，就只剩主观认知，没有客观约束力。
