Skip to content

Quick Start

Jump to bottom
dxx114514-stack edited this page Oct 17, 2026 · 4 revisions

快速开始

1. 获取

  • 下载 Release：Releases 提供 clijudge.exe（Windows）与 clijudge-linux.bin（Linux，重命名并加执行位：mv clijudge-linux.bin clijudge && chmod +x clijudge）
  • 或从源码编译：见 构建与测试

系统要求：Windows Vista+ / Linux（glibc）；评测 C/C++ 需要 PATH 上有 g++ / gcc；Linux / Android 下语言包联网下载已内置，无需 curl。

2. 熟悉帮助

clijudge help              # 总帮助
clijudge problem help      # 分模块帮助（article/contest/ide/problem/submit/displaylang）

语言检查按顶层命令判定：仅顶层 help 与 displaylang 不要求已配置显示语言；problem help 等子命令帮助同样受此限制，语言包缺失时会报错退出（见 显示语言）。

3. 创建第一道题

clijudge problem create "A + B Problem" \
  -describe statement.md -exampleio sample.in sample.out
# → Problem created with ID: 1
  • -describe 读取题面 Markdown；-exampleio 挂样例输入输出
  • 比较模式、SPJ、生成器、子任务等全部选项见 题目模块

4. 造测试点

clijudge problem testdata 1 create data.in data.out 1000 256 50
#                                        in    out   时间ms 内存MB 分值
clijudge problem testdata 1 list
  • in / out 传 - 表示占位测试点：内容由题目生成器在每次评测前生成
  • 时间/内存传 -1 或省略 → 回落题目级限制（再缺省 1000ms / 256MB），分值默认 25

5. 提交评测

clijudge problem submit 1 ac.cpp --as alice
=== Submission Result ===
Status: AC
Score: 100
Time: 15 ms
Memory: 3200 KB
User: alice

退出码：AC = 0，非 AC / 失败 = 1，可直接写进脚本。全部状态缩写见 其它模块。

6. 即写即跑（IDE 模式）

clijudge ide run main.cpp in.txt
  • 编译复用评测链路（可信沙箱 + compile_time_limit_ms，错误输出捕获后打印）
  • 运行为单进程受限沙箱：超时 10s、内存 256MB、进程上限 1、不经 shell
  • in.txt 内容重定向到 stdin；输出直接打印到终端；临时工作目录自动清理

7. 办一场比赛

clijudge contest create "寒假集训" "2026-01-01 10:00:00" "2026-01-01 12:00:00" 1 2
clijudge contest problem 1 1 submit sol.cpp --as alice   # 比赛内提交（受理即退出码 0）
clijudge contest problem 1 1 view                         # 该题提交记录
clijudge contest leaderboard 1                            # 排行榜
clijudge contest report 1 report.html                     # HTML 比赛报告

LemonLime CDF 双向交换：clijudge contest import x.cdf / clijudge contest export 1 x.cdf，见 比赛模块。

8. 数据在哪里

默认存储在可执行文件同级的 data/，环境变量 CLIJUDGE_DATA_DIR 可指定其它位置。备份数据 = 拷贝整个目录。目录结构、并发锁与迁移见 数据存储。

CliJudge · 仓库 · Issues · Releases · MIT License

🏠 Home

入门

命令参考

评测

系统

Clone this wiki locally