应按语义化层级组织HTML5结构：一、用header/nav/main/article/section/aside/footer替代div；二、HTML/CSS/JS物理分离；三、class名遵循BEM规范且语义化；四、用data-*属性解耦交互；五、CSS变量与JS同步状态。
如果您正在编写 HTML5 页面，但发现代码结构混乱、语义不清、CSS 和 JS 难以维护，则可能是由于未按语义化层级组织 HTML 结构。以下是按结构语义分层编写 HTML5 标签，并协同 CSS 与 JS 保持代码整洁的具体方法：
一、使用语义化区块标签替代 div 堆砌
HTML5 引入了具有明确含义的语义标签，可替代大量无意义的 <div>，使文档结构清晰、便于阅读与维护，同时提升可访问性与 SEO 效果。
1、用 <header> 包裹页面或章节顶部内容，如网站 logo、主导航栏。
2、用 <nav> 单独包裹导航链接集合，不用于页脚或侧边栏次要导航。
立即学习“前端免费学习笔记（深入）”；
3、用 <main> 包裹页面核心内容区域，且每个页面仅出现一次。
4、用 <article> 封装独立可分发的内容单元（如博客文章、新闻条目）。
5、用 <section> 表示有主题的文档分区，需配有标题（<h2>–<h6>），不可替代 <article> 或 <aside>。
6、用 <aside> 包裹与主内容相关但可独立存在的旁注内容（如侧边栏推荐、术语解释）。
7、用 <footer> 封装其父级区块（如 <article> 或 <body>）的尾部信息，避免全局页脚混用。
二、建立三层分离的文件组织结构
将 HTML、CSS、JS 按职责物理隔离，避免内联样式与脚本，确保各层专注单一功能，降低耦合度，提升协作效率与复用性。
1、HTML 文件中移除所有 style 属性和 onclick 等内联事件，仅保留结构与语义。
2、CSS 文件按功能模块拆分：基础重置（reset.css）、通用工具类（utils.css）、布局（layout.css）、组件（card.css、nav.css）及主题（theme.css）。
3、JS 文件按执行时机与作用域划分：初始化脚本（init.js）、交互行为（toggle-menu.js）、数据加载（fetch-posts.js），禁止在 HTML 中写 <script> 内联块。
4、在 HTML <head> 中通过 <link rel="stylesheet"> 引入 CSS，且按依赖顺序排列（重置 → 工具 → 布局 → 组件）。
5、在 HTML <body> 底部通过 <script src="..." defer> 加载 JS，确保 DOM 解析完成后再执行。
三、为语义标签添加语义化 class 命名
class 名称应反映内容职能而非视觉表现，避免使用 red-box、left-nav 等描述样式的名称，确保 HTML 结构变更时 CSS 无需重写。
1、采用 BEM（Block__Element--Modifier）规范命名，例如：nav-main__item--active、card-post__title。
2、区块名（Block）取自语义标签本身含义，如 header-site、article-news、section-features。
3、元素名（Element）使用双下划线连接，表示该区块内的组成部分，如 header-site__logo、article-news__meta。
4、修饰符（Modifier）用双短横分隔，表达状态或变体，如 button-primary--disabled、nav-main--expanded。
5、禁止在 class 中出现尺寸（big、small）、颜色（blue、bg-gray）、位置（top、right）等视觉词。
四、通过 data-* 属性解耦交互逻辑
将 JS 行为触发点从 class 名中剥离，改用 data-action、data-target 等自定义属性声明意图，使 HTML 保持语义纯净，CSS 不受 JS 控制逻辑干扰。
1、为需要折叠的菜单容器添加 data-action="toggle" 与 data-target="#mobile-menu"。
2、为模态框触发按钮添加 data-action="open-modal" 和 data-modal-id="contact-form"。
3、为表单提交按钮添加 data-action="submit-form" 与 data-validate="true"。
4、JS 统一监听 [data-action] 元素，根据属性值分发处理函数，避免为每个 class 单独写事件绑定。
5、CSS 可配合 [data-state="open"] 等属性选择器控制样式，如 nav[data-state="open"] { max-height: 500px; }。
五、利用 CSS 自定义属性与 JS 同步状态
当需要动态更新 UI 状态（如暗色模式、选中项高亮）时，通过 CSS 自定义属性（--color-bg）与 JS 修改 document.documentElement.style 实现样式与状态联动，避免重复操作 class。
1、在 :root 中预设主题变量，如 --color-bg: #fff;、--color-text: #333;、--spacing-md: 1rem;。
2、所有组件样式均使用 var(--color-bg) 替代硬编码颜色值。
3、JS 切换主题时，仅修改 document.documentElement.style.setProperty('--color-bg', '#1a1a1a')，无需增删 class。
4、为当前激活的导航项添加 data-current="true"，CSS 用 nav a[data-current="true"] { color: var(--color-primary); } 控制样式。
5、JS 控制滚动锚点高亮时，动态设置 section[id].dataset.active = 'true'，CSS 使用 section[data-active="true"] 匹配并应用强调样式。
