常见问题 FAQ

找不到答案？

如果这里没有解答你的问题，欢迎在 GitHub 上提交 Issue。

📝 需求相关

Q: 我写的需求越多越好吗？

A: 不是越多越好，而是越清晰、具体越好。

❌ 不好的需求

做一个很完美的电商系统，要有所有功能，界面要漂亮，性能要好。

✅ 好的需求

商品管理系统：

• 管理员可以添加、编辑、删除商品
• 商品包含：名称、价格、库存、分类
• 用户可以浏览商品列表，按分类筛选
• 用户可以搜索商品名称

Q: AI 能理解中文需求吗？

A: 可以！系统支持中文需求描述，你可以用日常语言来描述你想要的功能。

Q: 需求可以修改吗？

A: 目前生成后无法直接修改需求重新生成。建议先仔细思考需求再生成。如需修改，可以重新生成一个新项目。

🚀 运行相关

Q: 端口被占用怎么办？

A: 查看占用端口的进程并关闭：

macOS/Linux:

bash

        $
        lsof -i :3000
      

Windows:

cmd

        
        netstat -ano | findstr :3000
      

然后关闭对应的进程，或者修改项目配置使用其他端口。

Q: 后端启动报数据库连接错误

A: 检查以下几点：

1. 数据库是否启动 - 确保 MySQL/PostgreSQL 正在运行
2. 连接信息是否正确 - 检查 .env 文件中的数据库配置
3. 数据库是否存在 - 确保已创建对应的数据库

如果使用 SQLite，确保路径正确且有写入权限。

Q: 前端报 "CORS" 错误

A: 这是跨域问题，常见原因：

1. 后端没有配置 CORS
2. 前端 API 地址配置错误
3. 后端服务没有启动

解决方法：

1. 确保后端已启动
2. 检查前端 .env 文件中的 API 地址
3. 后端应该已经预配置好 CORS

Q: 安装依赖时报错

A: 常见解决方法：

1. 删除 node_modules 重装

bash

        $
        rm -rf node_modules && pnpm install
      

2. 清除缓存

bash

        $
        pnpm store prune
      

3. 检查 Node.js 版本是否正确

🔧 代码相关

Q: 生成的代码可以商用吗？

A: 生成的代码完全属于你，可以自由使用，包括商业用途。

Q: 生成的代码安全吗？

A: 生成的代码包含基础的安全措施：

• 密码加密存储
• JWT 认证
• 输入验证

但对于生产环境，建议进行安全审计和加固。

Q: 如何修改生成的代码？

A: 直接用代码编辑器（如 VS Code）打开项目文件夹即可编辑。建议：

1. 先了解项目结构
2. 阅读相应技术栈的文档
3. 从小改动开始

还有问题？

• 📖 查看对应技术栈的详细文档
• 💬 在 GitHub 上提交 Issue
• 🔍 搜索相关错误信息