Qoder报“无法连接到本地服务”是因Windows Loopback限制拦截localhost通信。可选四法：一、PowerShell执行CheckNetIsolation豁免；二、配置Lingma监听局域网IP；三、启用开发者模式；四、修改IDE JVM参数启用IPv4栈。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用Qoder时收到“无法连接到本地服务”报错，该提示通常指向客户端尝试通过127.0.0.1或localhost访问Lingma本地服务时被系统级Loopback限制拦截。Windows 10/11默认启用Loopback限制策略（尤其在UWP应用或部分IDE沙盒环境中），导致JetBrains等IDE插件无法与本地Lingma.exe进程建立回环通信。以下是多种独立可行的排查与解除方法：
一、禁用Windows Loopback限制（PowerShell方案）
该方法直接关闭系统对localhost回环通信的强制拦截，适用于标准Windows桌面环境且拥有管理员权限的用户。它修改的是应用容器网络策略，不影响系统全局安全模型。
1、以管理员身份启动Windows PowerShell。
2、执行命令：CheckNetIsolation LoopbackExempt -a -n="Microsoft.Win32WebViewHost"（此为IDE宿主进程典型包名，如使用IntelliJ IDEA，请替换为对应AppContainer名称，可通过Get-AppxPackage获取）。
3、若需覆盖所有本地应用，执行：CheckNetIsolation LoopbackExempt -a -n="*"。
4、运行CheckNetIsolation LoopbackExempt -s确认Lingma相关进程已出现在豁免列表中。
二、显式绑定至非Loopback地址并重配客户端
该方法绕过Loopback机制本身，让Lingma服务监听真实网卡IP（如192.168.x.x），再由IDE显式连接该地址，完全规避系统级回环策略检查。
1、编辑配置文件：C:\Users\[用户名]\AppData\Local\.lingma\config.json。
2、在根对象中添加或修改字段："host": "192.168.1.100"（请替换为本机实际局域网IP）。
3、同时设置"port": 22222（或其他未被占用端口）。
4、保存后彻底结束所有Lingma.exe进程，重启IDE并等待Qoder CN重新初始化。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
三、启用Windows功能“开发者模式”并验证AppContainer豁免
开发者模式会自动为调试类应用放宽网络策略，是JetBrains官方推荐的Qoder兼容性前置条件，可同步修复因UWP容器隔离引发的Loopback拒绝。
1、进入Windows设置 → 更新与安全 → 针对开发人员 → 启用开发者模式。
2、系统将自动安装必要组件并重启部分服务；重启完成后等待5分钟使策略生效。
3、打开命令提示符（非管理员），执行：netsh interface ipv4 show excludedportrange protocol=tcp，确认22222端口未出现在系统保留端口段中。
4、再次启动IDE，观察Qoder CN状态栏是否由“启动中”转为正常图标。
四、修改IDE JVM启动参数强制启用回环支持
该方法针对JetBrains系列IDE底层JVM，在启动阶段注入系统属性，指示Java网络栈忽略Windows Loopback限制逻辑，适用于无法修改系统策略的受限办公环境。
1、在IDE安装目录bin子文件夹中，找到idea64.exe.vmoptions（Windows）或idea.vmoptions（macOS/Linux）。
2、在文件末尾新增一行：-Djava.net.preferIPv4Stack=true。
3、另起一行追加：-Dnetworkaddress.cache.ttl=0。
4、保存文件，关闭所有IDE进程，重新以常规方式启动IDE并打开项目。
