Qoder连接GitHub失败需按四步修复：先验证网络连通性并清除错误代理；再手动配置hosts绑定GitHub权威IP；然后绑定正确远程仓库并启用自动提交；最后清除Qoder Git缓存并重启。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Qoder连接GitHub失败会导致代码无法拉取、提交不生效、协作编辑中断，常见于刚配置完Git插件却始终收不到远程变更通知的场景。问题根源往往不在Qoder本身，而是本地Git环境与GitHub服务之间的握手链路存在断裂点。
检查并修复本地Git网络连通性
第一步必须确认基础网络层是否真正可达，否则后续所有配置都是空中楼阁。
打开终端，执行：git ls-remote https://github.com/username/repo.git HEAD（将username/repo替换为你实际的仓库路径）。
若返回fatal: unable to connect to github.com或超时，说明底层HTTP/HTTPS连接已失败；此时不要继续配置Qoder，先解决网络问题。
执行ping github.com，如果持续返回127.0.0.1或Request timeout，大概率是DNS污染或hosts劫持——立即跳转到修改hosts文件步骤。
若ping通但git命令仍失败，运行git config --global --get http.proxy和git config --global --get https.proxy，若输出非空，且代理已停用或地址错误，执行git config --global --unset http.proxy && git config --global --unset https.proxy彻底清除。
手动校准GitHub域名解析（关键步骤）
国内直连GitHub常因DNS劫持导致连接被重定向至本地环回地址，必须强制指定权威IP才能打通链路。
Windows用户：用管理员权限打开C:\Windows\System32\drivers\etc\hosts，在文件末尾新增两行：
192.30.255.112 github.com
185.31.16.184 github.global.ssl.fastly.net
macOS/Linux用户：终端执行sudo nano /etc/hosts，同样追加上述两行，保存退出。
【务必删除原文件中所有含github.com的旧记录，包括www.github.com或带中文空格的行】，否则新规则不生效。
刷新DNS缓存：Windows执行ipconfig /flushdns；macOS/Linux无需刷新，直接关闭终端重启即可。
绑定正确远程仓库并启用自动提交
只有当Qoder识别到合法、可写入的远程Git上下文，同步机制才会启动。
第一步：在Qoder项目根目录打开集成终端，执行git remote get-url origin，确认输出为标准HTTPS或SSH格式（如https://github.com/yourname/project.git）。
第二步：若为空或报错，执行git remote add origin https://github.com/yourname/project.git（替换为你的仓库地址）。
第三步：进入Qoder设置页，搜索git.autoCommit，将其值设为true；再搜索git.branchAutoSetup并启用。
第四步：在终端执行git branch -u origin/main（若主干分支为master则改用origin/master），建立上游追踪关系。
验证是否成功：运行git branch -vv，当前分支后应显示[origin/main]字样，表示已绑定且可同步。
清除Qoder Git缓存并重启同步引擎
Qoder会缓存Git操作状态，若之前连接失败过，残留的错误上下文可能持续阻塞新连接尝试。
完全退出Qoder：右键系统托盘图标→选择“退出”，确保进程管理器中无qoder或lingma相关进程残留。
定位并删除Git缓存目录：
Windows路径为%APPDATA%\Qoder\GitCache；
macOS路径为~/Library/Caches/Qoder/GitCache；
Linux路径为~/.cache/Qoder/GitCache。
删除后重新启动Qoder，等待左下角状态栏出现“Git: ready”提示，再尝试执行一次git pull或保存一个文件触发自动提交。
