最基础的<img>标签必须包含src和alt属性：<img src="photo.jpg" alt="一只橘猫蹲在窗台上">；src需为有效路径，alt须具语义性且不可为空字符串（装饰图除外），width/height建议设置以避免布局偏移。

HTML 插入图片不用写“教程”，直接用 <img> 标签就行，但加不加 alt、要不要设 width/height、路径写相对还是绝对——这些地方一错，图就挂了，或者 SEO 和可访问性全丢。

怎么写最基础的 <img> 标签

必须有 src 和 alt 两个属性，缺一不可：

<img src="photo.jpg" alt="一只橘猫蹲在窗台上">

• src 值必须是有效路径（本地文件、CDN 地址或 base64 字符串），浏览器找不到会显示断链图标 + 控制台报 GET http://.../photo.jpg 404
• alt 不是“可选说明”，是屏幕阅读器读给视障用户听的内容，也是图片加载失败时的占位文字；空字符串 alt="" 表示“该图纯装饰，无需描述”
• 别写 <img src="..."></img> —— <img> 是自闭合标签，加结束标签是无效语法

src 路径写法和常见 404 原因

路径错是最常导致图片不显示的问题，不是代码写错了，而是文件没放对位置：

• 当前 HTML 在 /pages/index.html，图片在同级 /pages/photo.jpg → 用 src="photo.jpg"（相对路径，推荐）
• 图片在上一级 /photo.jpg → 用 src="../photo.jpg"（.. 表示上级目录）
• 图片在子目录 /images/cat.jpg → 用 src="images/cat.jpg"（不加 / 开头）
• 以 / 开头（如 src="/images/cat.jpg"）表示从根目录开始找，部署到子路径（如 https://site.com/blog/）时容易 404
• 用网络地址没问题，但注意：HTTP 网站里嵌 HTTPS 图片可以，反过来（HTTPS 页面加载 HTTP 图片）会被现代浏览器拦截并报 Mixed Content 错误

width 和 height 还要不要写

要写，但目的不是“控制大小”，而是防止布局偏移（layout shift）：

html-to-pptx-converter

使用 PptxGenJS 和 Python 解析，将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint（.pptx）演示文稿。

下载

立即学习“前端免费学习笔记（深入）”；

• 只写 width="300" 会让浏览器按比例自动算 height，但若原始图宽高比异常，可能拉伸变形
• 最好同时写 width 和 height（值用真实像素数），这样浏览器能预留空间，图片加载中不会把下面文字顶下去
• CSS 的 width: 100%; 会覆盖 HTML 属性，所以如果用 CSS 控制尺寸，HTML 里可以不写，但建议仍保留 width/height 作为“固有尺寸”供浏览器优化用
• 现代做法更倾向用 aspect-ratio CSS 属性替代硬编码宽高，但需注意 Safari 15.4+ 才完全支持

loading、decoding 这些新属性有什么用

它们不决定“能不能显示”，但影响性能和用户体验：

• loading="lazy"：让图片在滚动到视口附近才加载，减少首屏请求量；但不要用在首屏关键图上（比如 banner），否则可能白屏一闪
• decoding="async"：告诉浏览器用后台线程解码图片，避免阻塞主线程渲染；对大图（>1MB）效果明显
• referrerpolicy="no-referrer"：防止目标服务器看到你页面的 URL（尤其跨域图），避免泄露来源路径
• 所有这些属性都是渐进增强，不支持的浏览器直接忽略，不影响基础显示

真正容易被忽略的，是 alt 的语义准确性——写成“图片”或“照片”等于没写，还有开发完不检查控制台有没有 404，就直接扔到生产环境。图挂了没人说，但用户流失和搜索排名下降，是静悄悄发生的。