部署至Github Pages后Nuxt3站点Favicon无法显示求助

开发者阿泽

2026-6-24

解决Nuxt部署Github Pages后favicon不显示问题

针对你替换public文件夹favicon.ico后本地正常、Github Pages显示默认图标的问题，可按以下步骤排查修复：

显式指定favicon路径：在nuxt.config.ts的app.head中添加favicon的link标签，因你设置了baseURL: '/Portfolio/'，需确保路径匹配：

app: {
    head: {
        title: 'My title',
        link: [
            { rel: 'icon', type: 'image/x-icon', href: '/Portfolio/favicon.ico' }
        ]
    },
    baseURL: '/Portfolio/',
    buildAssetsDir: 'assets',
},

验证部署文件结构：查看Github Pages对应的gh-pages分支，确认favicon.ico是否存在于/Portfolio/路径下（public文件夹内容会直接复制到部署根目录，需和baseURL对应）。
清除浏览器缓存：用Ctrl+F5强制刷新页面，避免浏览器缓存旧的默认图标。