故障排查

未登录

• 现象：codeforge init 或 codeforge submit 提示 未登录；请先运行 codeforge login。
• 原因：本机没有保存可用的 CLI token。
• 处理方式：运行 codeforge login，按提示输入手机号和密码后重试。

目标目录已存在

• 现象：codeforge init http-server --language python 提示目标目录 http-server-python 已存在。
• 原因：CLI 不会覆盖已有目录，避免误删你的本地代码。
• 处理方式：换到一个空工作目录重新运行，或确认旧目录不再需要后删除再初始化。

语言不支持

• 现象：初始化时提示语言必须是 python 或 cpp，或提示课程不支持该语言。
• 原因：当前版本只支持 Python 和 C++，且不是每个项目都一定开放两种语言。
• 处理方式：在 Web 项目页确认可选语言，然后使用 --language python 或 --language cpp。

git clone 失败

• 现象：初始化时出现 git clone 失败。
• 原因：本机未安装 Git、网络不可达、模板仓库地址无法访问，或仓库权限不正确。
• 处理方式：确认 git --version 可用，检查网络和代理设置，再重新运行 codeforge init。

找不到 CodeForge 项目

• 现象：运行 codeforge submit 时提示 未找到 codeforge 项目；请先运行 codeforge init。
• 原因：当前目录不是 CLI 初始化出的项目目录，或者本机项目映射丢失。
• 处理方式：进入 codeforge init 创建的项目目录后重试；如果目录映射丢失，可以重新初始化项目。

评测失败

• 现象：codeforge submit 最终显示失败状态，并输出失败原因、构建日志或测试日志。
• 原因：代码没有满足当前阶段要求，或者构建、运行、测试过程出错。
• 处理方式：先阅读终端里的构建日志和测试日志，按失败原因修复代码后重新运行 codeforge submit。

评测仍在运行

• 现象：提交时提示当前已有评测在运行，CLI 继续显示该提交日志。
• 原因：同一用户同一时间只能有一个活跃评测，平台不会并发创建第二个提交。
• 处理方式：等待当前评测进入终态后再提交新的源码。如果连接中断，可以重新运行 codeforge submit 继续查看当前提交日志。