2025-9-13 博客更新心得 ​

1. base 与 public 的「魔法」 ​

• base 只需写仓库名：base: '/YOYO-Blog/'
• public 里的文件会被原样复制到站点根目录；页面里用 /xxx 引用时，VitePress 会自动在前面拼上 base，所以本地和线上都能直接命中。
  → 换仓库名时，只改 base 即可，所有资源路径零改动。

2. docs/post 下的 Markdown ​

• 属于内容源，会被编译成 HTML 并生成对应路由；
• 最终 URL = base + 文件目录结构 + .html（或简洁路由）。
  → 写文章只管放 .md，无需手动建 index.html。

3. 自定义 socialLinks 图标 ​

• 内置图标：直接写字符串，如 icon: 'github'。
• 自定义图标：必须用对象包裹 → icon: { svg: '<svg>...</svg>' }，不能只写裸 SVG 字符串。
  → 多余属性（xmlns、class、p-id）可删，只要浏览器能渲染即可。