跳到主要内容
版本:Current

管理图片

存放位置​

所有站点图片放在 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)。

引用检查清单​

  1. 文件确实在 public/images/...,路径大小写与仓库一致(Linux 构建区分大小写)。
  2. 组件中的字符串以 /images/ 开头。
  3. 本地 npm run dev 能显示;必要时再 npm run build && npm run preview。

图片 404 时页面会破版,排错见 常见错误。