环境变量未生效时需重启终端或ide、刷新系统变量、重启qoderwake服务并交叉验证：1. 关闭重开终端/ide；2. windows运行refreshenv，macos执行source ~/.zshrc；3. 终止qoderwake进程后重新启动；4. 用where/which、--version和echo命令逐级验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您完成 QoderWake 相关环境变量（如 QODER_HOME 或 PATH）的配置后，终端或 IDE 仍提示命令未识别或服务无法启动，则很可能是环境变量未及时生效。以下是确保配置立即生效的多种操作方法：
一、重启当前终端或命令行进程
环境变量在 Windows/macOS/Linux 中均以进程为作用域，新配置仅对后续启动的进程可见。关闭并重新打开终端（CMD、PowerShell、iTerm、Terminal.app）可加载最新变量。
1、关闭所有已打开的终端窗口或标签页。
2、重新启动终端程序。
3、执行 echo %QODER_HOME%（Windows）或 echo $QODER_HOME（macOS/Linux）验证变量是否输出正确路径。
二、重启集成开发环境（IDE）
JetBrains 系列 IDE（如 IntelliJ IDEA、PyCharm）在启动时读取一次系统环境变量，运行中不会动态刷新。若在 IDE 内使用 QoderWake 插件或 CLI 功能失败，需强制重启 IDE 才能继承更新后的变量。
1、点击菜单栏 File → Close Project 关闭当前项目。
2、点击 File → Exit 完全退出 IDE 进程（macOS 需确认 Dock 图标已消失）。
3、重新启动 IDE 并打开项目，检查 QoderWake 是否正常初始化。
三、刷新系统级环境变量（无需重启电脑）
Windows 和 macOS 均提供不重启系统的变量刷新机制，适用于已配置在“系统变量”或“用户变量”中的 QoderWake 路径。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
1、Windows：按 Win + R 输入 rundll32 sysdm.cpl,EditEnvironmentVariables，确认修改后，在 CMD 中执行 refreshenv（需先安装 Clink 或 Chocolatey）。
2、macOS：在终端中执行 source ~/.zshrc（zsh 用户）或 source ~/.bash_profile（bash 用户），确保 QODER_HOME 和 PATH 已写入对应配置文件。
四、重启 QoderWake 后台服务进程
QoderWake 依赖本地守护进程（如 qoderwake-daemon）维持长连接与上下文索引。环境变量变更后，该进程可能仍持有旧配置，需手动终止并拉起新实例。
1、Windows：打开任务管理器，结束名称含 qoderwake 或 lingma 的所有进程。
2、macOS/Linux：执行 pkill -f qoderwake 或 killall qoderwake-daemon。
3、进入 .lingma/bin/ 目录，运行 ./qoderwake start（Linux/macOS）或 qoderwake.exe start（Windows）。
五、验证环境变量是否生效
避免误判配置状态，应通过多层级命令交叉验证实际加载结果，而非仅依赖图形界面设置确认。
1、在全新终端中执行 where qoderwake（Windows）或 which qoderwake（macOS/Linux），确认返回路径包含已配置的 bin 目录。
2、执行 qoderwake --version，若返回版本号则说明 PATH 生效；若提示“不是内部或外部命令”，则需回溯步骤三重新刷新。
3、在 JetBrains IDE 中打开 Terminal，输入 echo $QODER_HOME，若输出为空，说明 IDE 未继承用户级变量，需改用系统级变量或重启 IDE。
