管理图片
存放位置
所有站点图片放在 public/images/,按模块分子目录,例如:
public/images/
├── Home/
├── Activity/
│ └── XinChunJiaNianHua/
├── Resources/
├── About/
├── Honor_Wall/
└── Partnership/
Vite 会把 public/ 复制到站点根路径,因此代码里写成:
const img = "/images/Activity/MyEvent/photo.webp";
<img src={img} alt="..." />
不要写成 src/assets/... 的 import,除非你明确要走打包哈希(当前项目惯例是 public 根路径)。
格式与体积
- 优先
.webp - 各部门、各活动使用独立子目录,避免把所有文件堆在同一层
- 大图先压缩再提交;首页 Hero 尤其影响首屏
alt 写实际含义;装饰性背景图可用空 alt 并 aria-hidden(见 CompactPageHeader)。
引用检查清单
- 文件确实在
public/images/...,路径大小写与仓库一致(Linux 构建区分大小写)。 - 组件中的字符串以
/images/开头。 - 本地
npm run dev能显示;必要时再npm run build && npm run preview。
图片 404 时页面会破版,排错见 常见错误。