前言
作为 AI 编程工具，MonkeyCode 在使用过程中会遇到各种问题。本文整理了新手最常见的问题和解决方案，帮助你快速上手，避开常见坑点。
一、账号与登录
Q1：免费版和专业版有什么区别？
答案：
| 功能 | 免费版 | 专业版（¥68/月） |
|---|---|---|
| 每日 AI 请求 | 20 次 | 无限 |
| 可用模型 | DeepSeek | 全部模型 |
| 云端环境时长 | 2 小时/天 | 无限 |
| 项目数量 | 3 个 | 无限 |
| Git 协作 | ❌ | ✅ |
| 私有化部署 | ❌ | ✅ |
建议：学习试用免费版，正式开发升级专业版。
Q2：登录后会话经常过期怎么办？
问题描述：
「写代码写到一半，提示需要重新登录」
原因：
- 浏览器 Cookie 设置问题
- 长时间无操作
- 网络波动
解决方案：
- 检查浏览器是否允许 Cookie
- 勾选「记住登录状态」
- 定期保存代码（Ctrl+S）
- 重要代码及时提交 Git
Q3：多设备登录会互斥吗？
答案：不会。
MonkeyCode 支持多设备同时登录，但同一账号的云端环境会共享时长。建议：
- 工作用电脑
- 查看进度用手机
- 避免同时在多个设备编辑同一文件
二、环境与项目
Q4：创建项目时应该选什么模板？
常见模板选择：
| 项目类型 | 推荐模板 |
|---|---|
| 后端 API | Node.js Express / Python FastAPI |
| 前端应用 | React + Vite / Vue 3 |
| 全栈项目 | Next.js / Nuxt.js |
| 数据科学 | Python + Jupyter |
| 移动端 | React Native / Flutter |
建议：
- 不确定的话选「空白模板」
- 让 AI 帮你初始化项目结构
Q5：云端环境启动很慢怎么办？
正常情况：
- 首次启动：30-60 秒
- 后续启动：5-10 秒（有缓存）
如果超过 1 分钟：
- 检查网络连接
- 尝试刷新页面
- 联系技术支持
优化建议：
- 常用项目保持活跃（每天打开一次）
- 大项目使用专属环境（资源更多）
Q6：本地代码如何导入 MonkeyCode？
方法 1：Git 导入（推荐）
1. 代码上传到 GitHub/GitLab/Gitee
2. MonkeyCode 选择「从 Git 导入」
3. 输入仓库地址
4. 自动克隆并配置环境
方法 2：直接上传
1. 打包代码为 ZIP
2. MonkeyCode 选择「上传项目」
3. 解压后配置依赖
方法 3：AI 重建
1. 描述项目结构和技术栈
2. AI 创建新项目
3. 手动复制核心代码
Q7：依赖安装失败怎么办？
常见错误：
ERROR: npm install failed
网络超时/镜像源问题
解决方案：
- 切换镜像源（MonkeyCode 默认使用国内镜像）
- 检查 package.json 是否有语法错误
- 删除 node_modules 重新安装
- 让 AI 帮你排查：「依赖安装失败，请帮我检查」
三、AI 使用技巧
Q8：AI 生成的代码跑不起来怎么办？
这是正常现象，AI 不是 100% 准确。
正确处理流程：
1. AI 生成代码
2. 运行测试
3. 发现错误 → 把错误信息发给 AI
4. AI 修复 → 再次测试
5. 重复直到通过
示例对话：
你：运行后报错 TypeError: Cannot read property 'map' of undefinedAI：这个问题是因为数据可能为空，我添加一个空值检查...你：还是报错，这次是...AI：明白了，需要同时修改这里...
关键：把 AI 当作结对编程的伙伴，不是一次性解决方案。
Q9：如何让 AI 生成更符合需求的代码？
差的 Prompt：
「写一个登录功能」
好的 Prompt：
「用 Node.js Express 写一个用户登录接口，要求：
1. 接收 email 和 password
2. 验证用户是否存在
3. 密码用 bcrypt 验证
4. 成功后返回 JWT token
5. 包含输入验证和错误处理
6. 添加单元测试」
Prompt 技巧：
- 明确技术栈
- 列出具体功能点
- 说明边界情况
- 要求包含测试
Q10：AI 不理解我的需求怎么办？
策略 1：分解任务
❌「做一个电商网站」
✅「第一步：创建用户注册接口」
✅「第二步：创建商品列表接口」
✅「第三步：创建购物车功能」
策略 2：提供示例
「参考这个代码风格：[粘贴示例代码]
请用类似的方式实现 XXX 功能」
策略 3：切换模型
- DeepSeek 不理解 → 试试 GPT-4
- 中文描述有问题 → 试试英文描述
Q11：如何避免 AI 生成重复代码？
问题：多次请求生成相似功能，代码不一致
解决方案：
-
建立项目规范文档
在项目中创建 CODING_STYLE.md 记录命名规范、代码风格、常用模式 让 AI 参考这个文档 -
复用已有代码
「参考 src/utils/validator.js 的风格， 写一个新的邮箱验证函数」 -
定期代码审查
用 AI 审查整个项目，发现不一致的地方
四、协作与 Git
Q12：如何与不使用 MonkeyCode 的同事协作？
答案：通过 Git。
MonkeyCode 完全兼容标准 Git 工作流：
MonkeyCode 开发 → 推送到 GitHub↓
同事本地拉取 → 正常开发 → 推送↓
MonkeyCode 拉取 → 继续开发
注意点：
- 提交信息写清楚
- 及时同步主分支
- 冲突时优先本地解决
Q13：AI 预审查太严格怎么办？
问题：AI 审查提出一堆问题，有些不重要
解决方案：
-
调整审查规则
团队设置 → 代码审查 → 自定义规则 关闭不重要的检查项 -
分级处理
- 阻止项：必须修复 - 建议项：可以忽略 - 提示项：仅供参考 -
人工确认
AI 审查只是参考，最终由人工决定
Q14：分支合并冲突如何解决？
MonkeyCode 的冲突解决流程：
1. 检测到冲突
2. AI 分析冲突内容
3. 提供合并建议
4. 确认或手动调整
5. 完成合并
最佳实践：
- 小步提交，减少冲突概率
- 合并前先拉取最新主分支
- 复杂冲突本地解决
五、性能与成本
Q15：如何控制 AI 使用成本？
按量计费场景（超出订阅额度）：
省钱技巧：
-
简单任务用便宜模型
变量命名、简单函数 → DeepSeek 核心逻辑、代码审查 → Claude/GPT-4 -
批量请求
❌ 一次问一个问题（10 次请求） ✅ 一次问所有问题（1 次请求） -
复用已有代码
先搜索项目内是否有类似实现 避免重复生成 -
定期查看用量
个人中心 → 用量统计 发现异常及时调整
Q16：云端环境休眠后数据会丢失吗？
答案：不会。
- 代码自动保存到 Git
- 未提交的代码会保留 7 天
- 休眠唤醒后恢复原状
建议：
- 离开前提交代码
- 重要修改及时 Push
Q17：项目大了之后变慢怎么办？
优化建议：
-
拆分项目
单体应用 → 微服务 大仓库 → 多仓库 -
升级环境配置
标准环境 → 高性能环境 （资源更多，费用略高） -
清理无用文件
删除 node_modules（会重新安装） 清理构建产物 -
使用增量编译
配置热重载 只编译变更的文件
六、安全与隐私
Q18：我的代码会被 AI 学习吗？
答案：取决于部署方式。
云端 SaaS 版：
- 代码用于提供服务的必要处理
- 不会用于训练公开模型
- 会话结束后环境销毁
私有化部署：
- 代码完全在内网
- AI 模型本地部署或专线访问
- 完全可控
建议：
- 敏感代码用私有化部署
- 核心算法可以本地开发
Q19：离职后如何收回权限？
管理员操作：
1. 管理后台 → 成员管理
2. 找到离职员工
3. 禁用账号
4. 转移项目所有权
5. 审计操作记录
建议：
- 定期审查成员权限
- 项目设置多个管理员
- 开启操作审计日志
Q20：如何防止 AI 生成有安全漏洞的代码？
多层防护：
- AI 预审查：自动检测常见漏洞
- 人工审查：核心代码必须人工审查
- 安全扫描：集成 SAST 工具
- 渗透测试：上线前安全测试
关键原则：
- AI 生成的代码不能直接上线
- 安全相关代码必须人工审查
- 定期进行安全培训
七、其他常见问题
Q21：支持移动端开发吗？
答案：支持，但有限制。
支持的场景：
- React Native 开发
- Flutter 开发
- 小程序开发
限制：
- 无法连接真机调试
- 模拟器在云端运行，有延迟
- 建议：代码在 MonkeyCode 写，真机测试本地做
Q22：可以离线使用吗？
答案：不能完全离线。
最低要求：
- 网络连接（访问云端环境）
- 浏览器（任何现代浏览器）
离线替代方案：
- 本地 VS Code + GitHub Copilot
- 代码同步到 MonkeyCode 继续
Q23：学生有优惠吗？
答案：有。
教育优惠：
- 专业版 5 折：¥34/月
- 需要学生证验证
- 有效期 1 年，可续期
申请方式：
个人中心 → 教育优惠 → 上传学生证 → 审核通过
总结：新手入门 Checklist
第一天：
第一周：
第一个月：
避坑口诀：
代码及时存 Git，AI 建议要审查
简单任务用便宜，复杂任务用高端
遇到问题先搜索，不行再问客服
定期回顾用量表，成本控制记心间
标签：MonkeyCode、常见问题、新手教程、避坑指南、FAQ