17c.com GitHub 常见问题 FAQ:从安装到部署

17c 技术团队
2026-07-18
FAQ问题解答故障排除

安装相关


Q1: 安装依赖时报错怎么办?


首先检查 Node.js 版本是否满足要求(>=18.0),然后尝试清除缓存后重新安装。


Q2: 支持哪些包管理器?


项目支持 npm、yarn 和 pnpm,推荐使用 pnpm 以获得更快的安装速度和更少的磁盘占用。


使用相关


Q3: 如何自定义主题?


项目提供了主题配置文件,你可以通过修改 theme.config.ts 来定制颜色、字体、间距等样式变量。


Q4: 如何接入第三方服务?


项目提供了插件机制,你可以通过编写插件来接入任何第三方服务。


部署相关


Q5: 支持哪些部署方式?


  • Vercel 一键部署
  • Docker 容器化部署
  • 传统服务器部署
  • 静态站点托管

  • Q6: 如何进行性能优化?


    项目内置了多项性能优化策略,包括代码分割、懒加载、资源压缩、CDN 加速等。


    安全相关


    Q7: 如何保证数据安全?


    项目遵循 OWASP 安全最佳实践,支持 CSRF 防护、XSS 过滤、SQL 注入防护等。


    更新与维护


    Q8: 如何升级到最新版本?


    通过 CLI 工具可以一键检查并升级到最新版本,升级前会自动备份当前配置。