BootCS 代码检查工具 - 在本地验证你的代码是否正确,然后提交到平台评测。
✨ 支持多语言: C, Java, Python, SQL - 同一个问题,自由选择你喜欢的语言!
- bootcs(推荐):容器版,无需配置环境,开箱即用
- bootcs-cli:本地版,适合开发和调试
# 1. 安装(只需一次) curl -fsSL https://raw.githubusercontent.com/bootcs-dev/bootcs-cli/main/scripts/install-docker.sh | bash # 2. 登录(只需一次) bootcs login # 3. 写代码,然后检查 cd ~/my-code/hello bootcs check cs50/hello # 4. 全部通过后,提交 bootcs submit cs50/hello
curl -fsSL https://raw.githubusercontent.com/bootcs-dev/bootcs-cli/main/scripts/install-docker.sh | bash需要先安装 Docker Desktop
bootcs --version
# 输出: bootcs 2.0.0cd bootcs-cli pip install -e .
验证:
bootcs-cli --version
# 输出: bootcs 2.0.0首次使用需要登录 GitHub:
bootcs login
按提示操作:
- 访问显示的链接
- 输入验证码
- 授权 BootCS
登录成功后,凭证会保存在本地,无需重复登录。
bootcs-cli 会自动识别你使用的编程语言:
cd ~/projects/hello bootcs check cs50/hello
示例输出:
🔍 Running checks for cs50/hello...
✅ hello.c exists
✅ hello.c compiles
✅ responds to name Emma
✅ responds to name Rodrigo
🎉 Results: 4 passed
同一个问题可以用不同语言完成! 系统根据目录中的源文件自动判断:
| 语言 | 文件名示例 | 自动检测 |
|---|---|---|
| C | hello.c |
✅ |
| Java | Hello.java |
✅ |
| Python | hello.py |
✅ |
| SQL | 1.sql, 2.sql |
✅ |
示例 - 用 Python 完成 hello 问题:
# hello.py name = input("What's your name? ") print(name)
bootcs check cs50/hello
# 自动识别为 Python,无需 -L 参数示例 - 用 Java 完成 hello 问题:
// Hello.java import java.util.Scanner; public class Hello { public static void main(String[] args) { Scanner scanner = new Scanner(System.in); System.out.print("What's your name? "); String name = scanner.nextLine(); System.out.println(name); } }
bootcs check cs50/hello
# 自动识别为 Java# 手动指定语言(通常不需要) bootcs check cs50/hello -L python bootcs check cs50/hello -L java bootcs check cs50/hello -L c # 强制重新下载检查脚本 bootcs check cs50/hello -u # 查看详细日志 bootcs check cs50/hello --log
本地检查全部通过后,提交到平台:
bootcs submit cs50/hello
系统会显示要提交的文件列表,确认后上传,并自动等待评测结果:
📦 Submitting cs50/hello
Files to submit:
• hello.c
Submit these files? [Y/n] Y
Submitting...
✅ Submitted successfully!
Submission ID: cmj9tcg3p00kfi7z4ih3l6quz
Short Hash: f3b2fac3
⏳ Evaluating... ⠹ (3s)
🎉 Evaluation Complete!
Status: SUCCESS
Passed: 4/4
✅ file_exists
✅ compiles
✅ emma
✅ rodrigo
# 跳过确认,直接提交 bootcs submit cs50/hello -y # 异步模式:提交后立即返回,不等待结果 bootcs submit cs50/hello --async # 自定义超时时间(默认 60 秒) bootcs submit cs50/hello --timeout 120
| 命令 | 说明 |
|---|---|
bootcs check <slug> |
检查代码 |
bootcs submit <slug> |
提交代码 |
bootcs login |
登录 |
bootcs logout |
登出 |
bootcs whoami |
查看当前用户 |
bootcs --help |
查看帮助 |
Q: 如何选择编程语言?
A: 创建对应语言的源文件即可:
- C:
hello.c - Java:
Hello.java(注意首字母大写,与类名一致) - Python:
hello.py
系统会自动检测。混合多个语言文件时,按数量多的为准。
Q: 能否手动指定语言?
A: 可以使用 -L 参数:bootcs check cs50/hello -L python
Q: Java 文件名必须大写吗?
A: 是的。Java 遵循 PascalCase 命名约定(如 Hello.java, MarioLess.java),这是 Java 语言的标准规范。
Error: Docker is not running
解决: 启动 Docker Desktop 应用。
Error: Could not find checks for 'xxx'
解决:
- 确认 slug 拼写正确(如
cs50/hello) - 确认已登录:
bootcs login
解决:
- 检查网络连接
- 重试:
bootcs login
🔧 高级选项(开发者)
如果你不想使用 Docker,可以用 pip 安装:
pip install git+https://github.com/bootcs-dev/bootcs-cli.git
统一语言适配器架构 (v2.0+):
- ✅ 单一 check 定义支持多语言(C/Java/Python)
- ✅ 自动语言检测和命名规则转换
- ✅ 编译语言与解释语言差异化处理
- ✅ 工厂模式 + 适配器模式实现
- ✅ 145+ 单元测试,100% 覆盖率
详见 docs/LANGUAGE-ADAPTER-DESIGN.md
需要自行配置 C/Python/Java 编译环境。
| 变量 | 说明 | 默认值 |
|---|---|---|
BOOTCS_API_URL |
API 地址 | https://api.bootcs.dev |
BOOTCS_CHECKS_PATH |
本地 checks 路径 | - |
git clone https://github.com/bootcs-dev/bootcs-cli.git cd bootcs-cli pip install -e ".[dev]" pytest