# Lorem Picsum

> 分类：`libs/media/` · 档位：**评估** · 更新时间：2026-11-17

## 1. 基本信息

| 项 | 内容 |
|---|---|
| 类型 | 占位图服务（HTTP API），不是 JS 库 |
| 版本 | 无版本号，接口长期稳定 |
| License | 服务免费；图片来自 Unsplash，遵循 Unsplash License；代码仓库 MIT（以仓库为准） |
| 维护方 | David Marby / Nijiko Yonskai |
| 站点 / 文档 | https://picsum.photos · https://github.com/DMarby/picsum-photos |

## 2. 一句话定位

最简单的随机占位图：改 URL 的宽高就能拿到一张真实照片，支持固定 seed 与灰度/模糊。
它解决"原型和演示时没有图"的问题，不承担生产内容的稳定性与版权审核。

## 3. 体积

| 项 | 说明 |
|---|---|
| JS | 0 |
| 图片 | 按请求尺寸返回 JPEG，实际字节随尺寸变化 |
| 请求 | 每个 `<img>` 一次外部请求 |

## 4. 核心用法

```html
<!-- 固定图片：seed 相同则每次都一样 -->
<img src="https://picsum.photos/seed/webtechs/800/600" alt="">

<!-- 随机 + 灰度 + 模糊 -->
<img src="https://picsum.photos/800/600?grayscale&blur=2" alt="">

<!-- 元数据与列表 -->
https://picsum.photos/id/237/info
https://picsum.photos/v2/list?page=1&limit=100
```

## 5. 适用 / 不适用

- **适用**：原型、设计稿占位、演示页、自动化截图测试的固定素材。
- **不适用**：生产环境主视觉、品牌图、需要 SLA 或版权可追溯的商业页面。

## 6. 硬缺口与已知坑

- 外部依赖：无 SLA，网络受限地区可能加载慢或失败。
- `?random=1` 每次请求都会换图并绕过缓存，容易造成重复下载。
- 内容随机，可能不契合品牌或场景；生产环境应换成自有素材。
- 无 CDN 地域保证，大量图片会拖慢首屏，需配合 `loading="lazy"` 与固定尺寸占位。
- 图片版权遵循 Unsplash License，但仍需自行确认使用场景。

## 7. 受限环境可用性

| 环境 | 结论 | 说明 |
|---|---|---|
| 无构建 | 可用 | 直接写 URL |
| 打包器 | 可用 | 但建议只在开发环境使用 |
| SSR | 可用 | 纯 URL |
| 离线 / 内网 | 不可用 | 需本地占位图 |

## 8. 稳定性评分

| 维度 | 评分 | 依据 |
|---|---|---|
| 维护活跃度 | 3 | 服务稳定，更新不频繁 |
| 版本与破坏性变更 | 5 | 无版本概念，接口长期不变 |
| 采用度 | 5 | 原型与示例中的默认选择 |
| 体积与按需 | 4 | 无 JS，图片体积可控 |
| 生态兼容 | 5 | 任何 `<img>` 可用 |
| License | 4 | 图片为 Unsplash License，商用需确认 |

## 9. 同类对比

| 服务 | 优势 | 劣势 | 何时选它 |
|---|---|---|---|
| placehold.co | SVG 文本占位、可指定颜色与文字 | 不是真实照片 | 需要尺寸标注的线框 |
| dummyimage.com | 老牌、格式多 | 界面与图片风格旧 | 简单占位 |
| LoremFlickr | 可按关键词取图 | 质量不稳定 | 需要主题相关占位 |
| DiceBear | 生成头像/插画风 | 只适合头像类 | 用户头像占位 |
| Unsplash API | 真实高质量图、可搜索 | 需要 key 与配额 | 接近生产的选图 |
| Pexels / Pixabay API | 免费图库 + API | 需要 key | 生产素材 |
