2026-04-29-23-02-56 - 部署logo到public目录+修复favicon 404

工程分析/经验记录.md

@@ -172,4 +172,28 @@ AI 助手运行的容器/环境与项目实际开发环境分离，后者才装
 
 ---
 
+## 2026-04-29-23-02-56 — Logo 部署 + Favicon 404
+
+### A. 具体问题
+1. `Sidebar.tsx` 引用 `/Logo.png` 但文件不存在，logo 无法显示
+2. 浏览器控制台报 `favicon.ico 404`
+
+### B. 产生原因
+1. `logo_square.png` 位于项目根目录，但 Vite 不会自动将根目录文件暴露为静态资源
+2. 前端代码引用路径为 `/Logo.png`（首字母大写），与实际文件名 `logo_square.png` 不匹配
+3. `index.html` 无 favicon 声明，浏览器默认请求 `/favicon.ico`
+
+### C. 解决方案
+1. 创建 `public/` 目录（Vite 原生支持，自动暴露到根 URL）
+2. 将 `logo_square.png` 复制为 `public/logo.png`
+3. `Sidebar.tsx` 引用路径改为 `/logo.png`
+4. `index.html` 添加 `<link rel="icon" type="image/png" href="/logo.png" />`
+
+### D. 后续如何避免问题
+1. 静态资源（图片、字体、favicon）统一放入 `public/` 目录
+2. 资源文件名与代码引用严格保持大小写一致
+3. 每个项目初始化时都配置好 favicon，避免浏览器自动请求不存在的 .ico
+
+---
+
 > 新增经验请追加到文件末尾，保持时间倒序或正序均可，但需确保每条经验包含完整的 A/B/C/D 四段。