Qoder 独立软件・后端开发入门文档（替代 IDEA）
一、Qoder 独立版是什么
Qoder IDE 是独立的 AI 代码编辑器（非插件） ，可直接打开你原来的 IDEA 后端项目（Maven/Gradle），支持：
- Java、SpringBoot、MyBatis、SQL 智能识别与补全
- 直接编译、启动 SpringBoot 项目
- 一键生成 Controller/Service/Mapper/Entity
- 内置终端、Git、Maven 工具
- 完全替代 IDEA 做后端开发
二、下载与安装（Windows / Mac）
1. 下载
官网下载独立安装包：�� https://qoder.com/downloadQoder
选择对应系统：
- Windows：.exe 安装包
- Mac：.dmg 镜像
2. 安装
- Windows：双击 .exe → 一路默认安装
- Mac：拖拽 Qoder 到应用程序
3. 启动与登录
- 打开 Qoder IDE
- 首次启动需要注册 / 登录 Qoder 账号 （免费额度够用），不够用可以购买订阅的套餐。最少2000一个月的。10刀左右。
三、打开你原来的 IDEA 后端项目
1. 打开项目根目录
- Qoder 启动页 → Open Folder
- 选择你 SpringBoot 项目的根目录 （包含 pom.xml 或 build.gradle 的那一层）
- Qoder 自动索引项目（首次打开约 1--3 分钟）
2. 项目结构完全兼容 IDEA
打开后你会看到和 IDEA 一模一样的结构：
plaintext
src/main/java
src/main/resources
pom.xml
- Java 源码、XML、YML 全部正常高亮
- 包名、类名、依赖关系自动识别
四、后端开发必备配置（必做）
1. 配置 JDK（关键，否则代码爆红）
- 左下角 ⚙️（设置）→ Java 运行环境
- 选择你本机已安装的 JDK（和 IDEA 用同一个：JDK8/11/17）
- 等待索引完成 → 所有 Java 代码不再爆红Qoder
2. 配置 Maven（拉取依赖）
- 设置 → Maven 配置
- 选择你的 settings.xml（和 IDEA 共用同一个）
- 点击 Reload Maven Project （右侧边栏 Maven 图标）→ 自动下载所有依赖，和 IDEA 一致
3. 开启 SpringBoot / MyBatis 支持
设置 → 开启：
- SpringBoot 支持 （识别 @Controller、@Service 等）
- MyBatis 支持 （Mapper 接口与 XML 跳转、SQL 提示）
五、日常后端开发操作（替代 IDEA 核心功能）
1. 新建 Java 类 / 接口
- 右键包名 → New → Java Class
- 输入类名 → 自动生成包声明
2. 一键生成 CRUD（最强功能）
在实体类（如 User.java）编辑页，按：
- Windows：Ctrl + I
- Mac：Cmd + I
输入指令：
生成 User 的 Controller、Service、ServiceImpl、Mapper、Mapper XML，包含分页、新增、修改、删除
→ Qoder 自动生成所有层代码，可直接运行
3. 编写接口 & 自动补全
- 写 @RestController、@RequestMapping 自动提示
- 方法参数、返回值、JSON 序列化智能补全
- YML 数据库、Redis、端口配置自动提示
4. 运行 SpringBoot 项目（无需 IDEA）
- 打开 主启动类 （如 Application.java）
- 点击左侧 ▶️（运行）按钮
- 内置终端自动输出日志，和 IDEA 控制台一致
- 支持热部署（需配置 spring-boot-devtools）
5. 调试（Debug）
- 点击行号左侧设置断点
- 点击 ��（Debug）按钮启动
- 支持：查看变量、断点调试、表达式求值
6. Git 操作
右侧边栏 Git 图标：
- 提交、拉取、推送、分支切换
- 冲突解决界面和 IDEA 类似
六、从 IDEA 迁移到 Qoder 的差异与习惯调整
相同（无缝过渡）
- 项目结构、配置文件完全不变
- Maven/Gradle 依赖、JDK 配置复用
- 快捷键可导入 IDEA 键位（设置 → 键盘映射 → 选择 IntelliJ IDEA）
不同（需适应）
- 无 IDEA 的「Module」概念，直接打开根目录
- 部分冷门插件（如 Lombok 增强）需用 Qoder 自带功能替代
- 内置终端，无需额外开 CMD/Terminal
七、常见问题（必看）
1. 打开项目后 Java 代码爆红
- 原因：JDK 未配置或配置错误
- 解决：设置 → Java 运行环境 → 选择正确 JDK → 重启 Qoder
2. Maven 依赖下载失败
- 原因：Maven 镜像未配置
- 解决：在设置里搜索User Settings，配置 settings.xml 阿里云镜像 → Reload Maven
3. 无法启动 SpringBoot
- 原因：主类未识别或端口占用
- 解决：
- 右键主类 → Run
- 或在终端手动执行：mvn spring-boot:run
4. AI 没反应 / 提示无权限
- 解决：登录 Qoder 账号，免费额度足够日常开发
八、推荐常用快捷键（和 IDEA 一致）
表格
|--------------------|-----------------|-------------|-------|
| 功能 | Windows | Mac | |
| 格式化代码 | Ctrl+Alt+L | Cmd+Alt+L | |
| 生成代码（get/set/ 构造器） | Alt+Insert | Cmd+N | |
| 查找类 / 文件 | Ctrl+N | Cmd+N | |
| 全局搜索 | Ctrl+Shift+F | Cmd+Shift+F | |
| AI 行间对话（生成 / 解释代码） | Ctrl+I | Cmd+I | Qoder |
九、小结
你现在可以：
- 卸载 IDEA 或不再打开它
- 用 Qoder 独立软件直接打开原有后端项目
- 配置 JDK/Maven → 正常开发、运行、调试
- 用 AI 大幅提升 CRUD、排错、重构效率