（基于Web标准与团队协作构建）
一、基础规范
- HTML5标准遵循
- 使用严格HTML5文档类型声明：
<!DOCTYPE html>，确保浏览器以标准模式渲染页面。
- 使用严格HTML5文档类型声明：
- 声明字符编码为UTF-8，避免乱码问题：
<meta charset="utf-8">。
- 声明字符编码为UTF-8，避免乱码问题：
- 启用IE=edge模式，确保兼容性：
<meta http-equiv="x-ua-compatible" content="ie=edge">。
- 启用IE=edge模式，确保兼容性：
- HTML5标准遵循
- 标签与属性规范
- 标签闭合：所有标签必须闭合，自闭合标签（如
<img>、
- 标签闭合：所有标签必须闭合，自闭合标签（如
- 属性格式：
- 属性名与值均使用小写，属性值必须用双引号包裹（如
class="container"）。
- 属性名与值均使用小写，属性值必须用双引号包裹（如
- 布尔属性（如
checked、disabled）存在即视为true，无需显式赋值。
- 布尔属性（如
- 属性格式：
- 属性顺序：按
class（高复用性）→id（唯一性）→data-*→src/for→type/href→value→title/alt→role/aria-*顺序排列。
- 属性顺序：按
- 标签与属性规范
二、结构规范
- 文件命名与目录
- 文件名统一使用小写字母、数字和下划线（如
index.html、header_component.html）。
- 文件名统一使用小写字母、数字和下划线（如
- 目录结构按功能划分（如
/components存放可复用组件、/assets存放资源文件）。
- 目录结构按功能划分（如
- 文件命名与目录
- HTML文档结构
- 视觉与逻辑一致性：HTML结构需与视觉呈现顺序匹配，重要内容优先放置以优化SEO。
- 语义化标签：优先使用
<header>、<nav>、<main>、<section>等标签替代<div>，提升可访问性。
- 语义化标签：优先使用
- 避免嵌套错误：如
<p>标签内不可嵌套块级元素（如<div>），<a>标签不可嵌套其他<a>标签。
- 避免嵌套错误：如
- HTML文档结构
三、代码格式规范
- 缩进与空行
- 使用两个空格缩进（避免制表符），嵌套标签需缩进一次。
- 模块间用空行分隔，保持代码可读性。
- 缩进与空行
- 特殊字符处理
- 转义HTML实体（如
<、&），避免解析错误。
- 转义HTML实体（如
- 图片标签必须包含
alt属性（如<img src="image.jpg" alt="描述">）。
- 图片标签必须包含
- 特殊字符处理
- 注释规范
- 使用
<!-- 注释内容 -->格式，避免冗余注释。
- 使用
- 注释规范
四、语义化与可访问性
- 语义化标签应用
- 使用
<article>、<section>、<aside>等标签明确内容边界，便于屏幕阅读器解析。
- 使用
- 为表单元素添加
<label>标签（如<label for="username">用户名</label>）。
- 为表单元素添加
- 语义化标签应用
- ARIA角色与属性
- 在复杂组件（如自定义下拉菜单）中添加ARIA属性（如
role="navigation"），提升可访问性。
- 在复杂组件（如自定义下拉菜单）中添加ARIA属性（如
- ARIA角色与属性
- 背景图片处理
- 同时提供HTML文本与CSS背景图，确保CSS失效时内容可读。
- 背景图片处理
五、性能优化规范
- 标签精简
- 减少不必要的嵌套标签，使用CSS替代表格布局。
- 图片懒加载：通过JavaScript或
loading="lazy"属性延迟加载非首屏图片。
- 图片懒加载：通过JavaScript或
- 标签精简
- 资源加载优化
- CSS文件置于
<head>中，JS文件置于<body>底部，减少阻塞渲染。
- CSS文件置于
- 合并CSS/JS文件，减少HTTP请求次数。
- 资源加载优化
- 响应式设计
- 使用
<meta name="viewport" content="width=device-width, initial-scale=1.0">适配移动端。
- 使用
- 采用媒体查询（Media Query）实现布局自适应。
- 响应式设计
六、版本控制与协作规范
- Git使用规范
- 采用分支模型（如Git Flow），功能开发分支命名
feature/xxx，修复分支命名hotfix/xxx。
- 采用分支模型（如Git Flow），功能开发分支命名
- 提交信息遵循
<类型>(<范围>): <简短描述>格式（如fix(button): 修复按钮点击延迟）。
- 提交信息遵循
- Git使用规范
- 代码审查标准
- 检查标签闭合、属性顺序、语义化使用等基础规范。
- 评估性能优化措施（如图片压缩、懒加载）的合理性。
- 代码审查标准
- 网页规范网页
- 维护团队共享的HTML规范网页（如Markdown格式），包含代码示例与常见问题解答。
- 网页规范网页
七、工具与框架规范
- 编辑器配置
- 统一使用VS Code，安装ESLint+HTMLHint插件，配置自动格式化规则（如2空格缩进、双引号属性）。
- 编辑器配置
- 预处理器与框架
- 使用Pug（原Jade）替代HTML编写模板，提升开发效率。
- 采用组件化开发（如React或Vue），遵循单文件组件（SFC）规范。
- 预处理器与框架
- 测试与验证
- 使用W3C HTML验证工具检查代码合规性。
- 集成自动化测试（如Selenium），验证页面交互逻辑。
- 测试与验证
八、动态内容与交互规范
- JavaScript交互
- 避免在HTML中直接编写内联事件处理（如
onclick），改用addEventListener。
- 避免在HTML中直接编写内联事件处理（如
- 使用
defer属性异步加载JS文件，避免阻塞DOM解析。
- 使用
- JavaScript交互
- Web组件标准
- 自定义元素需遵循Web组件规范，定义
<template>与<style>封装逻辑与样式。
- 自定义元素需遵循Web组件规范，定义
- Web组件标准
方案实施要点说明
- 渐进式落地：分阶段推行规范（如先强制闭合标签，再优化属性顺序）。
- 自动化工具：集成ESLint+Prettier实现代码格式统一，减少人工审查成本。
- 文化渗透：通过内部分享会、代码评审会强化规范意识。
此规范通过结构化分层、技术工具支撑与团队协作机制，兼顾开发效率与代码质量，适用于中大型Web项目。
套图传送门THE END
