第六部分：常见问题
6.1 环境问题
Q: Node.js 版本不兼容？
A: 升级到 18.x 或更高版本，推荐使用 nvm 管理版本。
Q: npm install 失败？
A:
- 换国内镜像源：
npm config set registry https://registry.npmmirror.com - 删除
node_modules和package-lock.json重新安装
6.2 配置问题
Q: 环境变量不生效？
A: 修改环境变量后需重启开发服务器，生产环境需重新构建。
Q: Giscus 不显示？
A: 检查：
- Giscus App 已安装
- 仓库启用 Discussions
- 环境变量配置正确
- 网站已部署到线上
Q: Live2D 不显示？
A: 检查模型路径、文件是否存在，或设为空数组禁用。
6.3 构建问题
Q: 构建失败？
A:
- 查看错误信息
- 运行
npm run lint检查代码 - 检查导入路径是否正确
Q: 图片不显示？
A: 检查：
NEXT_PUBLIC_SITE_URL配置正确- 使用相对路径引用图片
- 图片文件已复制到输出目录
6.4 部署问题
Q: 部署后 404？
A:
- 确认 Output Directory 设为
output - 检查
next.config.js中trailingSlash: true - 确认链接以
/结尾
Q: 样式丢失？
A: 检查 NEXT_PUBLIC_SITE_URL 配置正确，强制刷新浏览器。
6.5 性能问题
Q: 网站加载慢？
A:
- 优化图片大小和格式
- 禁用 Live2D（如使用）
- 减少粒子数量
- 使用 CDN 加速
6.6 其他问题
Q: 如何备份？
A: 使用 Git 版本控制，定期提交推送，备份 content/ 目录。
Q: 改坏了怎么办？
A: 使用 Git 回退：git checkout -- filename 或 git reset --hard HEAD。
Q: 如何更新项目？
A: 如 fork 了原项目，添加上游 remote 后合并更新。