Qoder项目导入迁移指南：高效适配现有项目
首要原则：Qoder 不支持将 IDE 项目（如 Eclipse）进行直接格式“转换”。它的工作机制是基于项目中的标准构建描述文件（例如 pom.xml、build.gradle）进行智能识别与项目适配。核心操作是定位并打开项目的根目录，后续的索引与语言支持均由 Qoder 自动完成。
针对现有项目迁移至 Qoder 以启用 AI 辅助编程，请根据项目来源选择以下对应路径。
一、直接打开文件夹（通用型，适用于所有标准项目）
Qoder 的核心设计遵循文件系统逻辑。只要项目根目录存在标准的构建描述文件，它便能自动启用对应的编程语言与框架支持。因此，最直接的方法就是打开项目文件夹。
关键前提是，项目根目录下必须包含至少一个主流构建文件，例如：pom.xml（Ma ven）、build.gradle（Gradle）、package.json（Node.js/React/Vue）、tsconfig.json（TypeScript）。
操作流程：启动 Qoder IDE，点击【文件】→【打开文件夹】，或使用快捷键 Ctrl+K Ctrl+O（Windows/Linux）/ Cmd+K Cmd+O（Mac）。在文件选择器中，务必定位到包含上述构建文件的最外层项目根目录，而非内部的 src 或模块子目录。
打开后，等待右下角索引进度完成。随后，左侧资源管理器将展示完整项目树，Java 类、Vue 单文件组件、SQL 脚本等均会获得语法高亮与代码导航能力。
二、命令行一键打开（推荐开发者日常使用）
对于习惯终端工作流的开发者，通过命令行启动能精准定位当前工作目录，避免图形界面下的路径选择错误。
执行步骤：首先通过终端导航至项目根目录，使用命令 cd /path/to/your/project，随后运行 qoder .（注意末尾的英文句点，代表当前目录）。
若系统返回“命令未找到”，表明 Qoder 命令行工具未全局安装。可通过执行 qoder --version 验证，若未安装，需前往官网下载并配置安装包。
命令执行成功后，Qoder 将以当前目录为工作区启动，并立即触发项目全量索引。首次打开大型工程时，可在侧边栏状态栏观察实时索引进度。
三、从 IntelliJ IDEA 迁移（保留原项目配置逻辑）
由 IntelliJ IDEA 迁移至 Qoder 独立版最为便捷。Qoder 能够直接解析 IDEA 项目目录中的 .idea 元数据，无缝复用 JDK、Ma ven、Spring Boot 等现有配置，实现近乎零成本的项目迁移。
迁移前请确保已关闭 IntelliJ IDEA，以避免项目文件被锁定。然后在 Qoder 中选择【文件】→【打开文件夹】，直接指向原 IDEA 项目的根目录（即包含 .idea 文件夹与 pom.xml 或 build.gradle 的目录）。
首次加载后，需手动配置两项：进入【设置】→【Java 运行环境】，指定与 IDEA 项目一致的 JDK 安装路径（例如 /Library/Ja va/Ja vaVirtualMachines/jdk-17.jdk 或 C:\Program Files\Ja va\jdk-11.0.18）。随后进入【设置】→【Ma ven】，加载同一份 settings.xml 配置文件（通常位于 ~/.m2/settings.xml），并点击【Reload Ma ven Project】同步依赖关系。
最后，在设置中启用【SpringBoot 支持】与【MyBatis 支持】开关，确保 @Controller、@MapperScan 等注解被正确识别，并实现 XML 映射文件与接口之间的双向导航。
四、从 VS Code 迁移（复用配置与插件生态）
得益于其底层架构，QoderWake 能高度兼容 VS Code 的配置体系。你可以直接迁移用户设置、键盘绑定、代码片段及扩展插件，大幅减少环境重建工作。
具体实施：首先在 VS Code 中按 Ctrl+Shift+P 打开命令面板，运行【Preferences: Open Settings (JSON)】，复制 JSON 配置的全部内容。请注意，QoderWake 仅支持标准 JSON 格式，务必移除所有以 // 开头的注释行。随后在 QoderWake 中执行相同操作，清空默认配置后粘贴已清理的 JSON 内容，保存并重启 IDE。
接着，在 VS Code 终端内运行 code --list-extensions > vscode-extensions.txt，导出已安装的扩展 ID 列表。在 QoderWake 终端中，针对列表中的每个 ID（例如 ms-python.python），执行 qoder --install-extension [extension-id] 命令进行安装。需注意跳过 QoderWake 已内置的核心扩展，如 qoder.qoder-core、continue.continue。
最后，将 VS Code 的 keybindings.json 文件导入 QoderWake，并验证其中如 "when": "editorTextFocus" 等条件字段是否依然生效，确保自定义快捷键功能完整。
五、Eclipse 项目适配（无插件依赖，仅结构迁移）
Eclipse 项目因其依赖 .project 和 .classpath 等私有元数据，迁移时较为特殊。核心思路是剥离 IDE 特定文件，将项目结构标准化为 Ma ven 或 Gradle 项目，使 Qoder 能够基于构建文件正确建立依赖图和语义模型。
首先检查项目根目录：若已存在 pom.xml 或 build.gradle 文件，直接采用【方法一】打开即可。
若项目仅包含 .project/.classpath 而缺少构建工具，则需手动初始化为 Ma ven 项目：在项目根目录打开终端，执行命令 mvn archetype:generate -DgroupId=com.example -DartifactId=my-eclipse-project -DarchetypeArtifactId=ma ven-archetype-quickstart -DinteractiveMode=false。生成基础结构后，将原有 src/main/ja va 下的源代码迁移至新项目的对应目录中。
随后，删除遗留的 Eclipse 配置文件，包括 .project、.classpath 及 .settings 目录，仅保留 pom.xml 与标准化后的 src 目录结构。使用 Qoder 重新打开此目录，它将识别为标准 Ma ven 项目并自动解析依赖。
对于需要保留的 Eclipse 特定资源（如 server.xml、.launch 配置文件），可将其移至 resources 目录。Qoder 不会主动索引这些文件，但不影响你在项目中手动编辑和引用。
