qoderwake无法识别编译器时，需依次验证终端可执行性、手动注入path至cursor.env、显式设置编译器路径、清除.qoderwake缓存并重载工具链、或用命令行启动继承环境变量。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用QoderWake时发现其无法识别已安装的编译器路径，导致项目构建失败或Kit显示为“未配置”，则问题通常源于环境变量未继承、路径未显式声明或配置文件解析异常。以下是解决此问题的具体操作步骤：
一、验证系统级编译器可执行性
QoderWake自身不自动扫描系统PATH，需先确认编译器在终端中可直接调用，这是后续所有配置生效的前提。
1、打开系统终端（Windows使用CMD或PowerShell，Linux/macOS使用默认Shell）。
2、输入 g++ --version 或 clang++ --version（根据实际安装的编译器选择）。
3、若返回版本信息，则说明编译器已正确安装且PATH有效；若提示 command not found 或 'g++' is not recognized，则需先修正系统环境变量。
二、手动注入编译器路径至QoderWake运行环境
QoderWake在GUI模式下启动时通常不继承用户shell的PATH，必须通过配置文件强制注入编译器所在目录。
1、定位QoderWake配置目录：Windows为 %APPDATA%\QoderWake\，Linux为 ~/.config/QoderWake/，macOS为 ~/Library/Application Support/QoderWake/。
2、在该目录下创建或编辑文件 cursor.env（纯文本格式，无扩展名）。
3、向该文件写入以下内容（以MinGW为例，路径请按实际安装位置替换）：
PATH="/c/Qt/Tools/mingw112_64/bin:/usr/bin:/bin"。
4、保存文件后，**完全退出QoderWake进程**（包括后台任务），再重新启动。
三、在QoderWake设置中显式指定编译器二进制路径
当自动探测失败时，必须绕过默认扫描逻辑，直接绑定编译器与调试器的绝对路径。
1、启动QoderWake，进入 Settings → Extensions → QoderWake → Compiler Path。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、在 C++ Compiler 输入框中，粘贴g++完整路径，例如：C:\Qt\Tools\mingw112_64\bin\g++.exe（Windows）或 /usr/bin/g++（Linux）。
3、在 Debugger Path 输入框中，填写对应调试器路径，如 C:\Qt\Tools\mingw112_64\bin\gdb.exe 或 /usr/bin/gdb。
4、勾选 Enable custom compiler override 选项并保存设置。
四、检查并重建项目级工具链缓存
QoderWake会为每个工作区缓存工具链元数据，旧缓存可能残留无效路径，导致新配置不生效。
1、关闭当前打开的项目文件夹。
2、在项目根目录下，删除名为 .qoderwake 的隐藏文件夹（若存在）。
3、重新打开该文件夹，等待QoderWake重新索引。
4、在命令面板（Ctrl+Shift+P）中执行 QoderWake: Reload Toolchain Cache。
五、使用命令行启动强制继承系统环境
规避GUI启动导致的环境隔离问题，让QoderWake直接复用当前终端的完整PATH。
1、在已确认 g++ --version 成功的终端中，导航至QoderWake安装目录。
2、执行启动命令：
Windows：QoderWake.exe --no-sandbox
Linux：./qoderwake --no-sandbox
macOS：open -n -a QoderWake --args --no-sandbox。
3、启动后立即打开项目，观察状态栏是否显示有效编译器标识。
