浏览器打开就能跑真代码的中文编程课堂 · 零安装 · 纯静态 · MIT 开源
Python · SQL · JavaScript · TypeScript 全部在浏览器内真实运行
在线体验:codepath-academy.pages.dev(免费开放;首次运行 Python/SQL 需联网加载浏览器执行环境)
这是一个纯静态、零后端的项目。您的每一个 Star,都是它被更多人看见的唯一途径。
点亮右上角 Star 后,即可免费解锁站内全部高级模块(AI 应用开发路线、大模型部署/微调/LoRA/QLoRA/RAG 等 10 个进阶模块)。
领取步骤(30 秒):
- 点本仓库右上角 ⭐ Star
- 新建 issue 留言你的 GitHub 用户名(一键跳转,已预填模板)
- 收到解锁码后,在站点右上角 ⭐ 按钮 里填入 → 立即解锁
解锁码仅在本机浏览器校验,不上传任何服务器。原理与算法见 dist/star-unlock.js(纯前端校验和,开源可审计)。
30 条学习路径 · 232 个小节 · 30 节先修衔接课 · 6 个游戏关卡 · 17 个综合项目 · 14 个每日挑战
课程在浏览器里真实运行 Python、SQL、JavaScript、TypeScript(Pyodide + SQLite + 真实 TS 5.9.3 编译器),并配有两套「拿证据说话」的毕业验收:接管自己的 AI 辅助项目,以及分析和修改陌生 GitHub 项目。
| 亮点 | 实现 |
|---|---|
| 真 Python 在浏览器跑 | 自托管 Pyodide(wasm 版 CPython),不走公共 CDN,无后端依赖 |
| 真 TypeScript 编译检查 | 内嵌 TS 5.9.3 编译器,练习做 strict 检查,不是假高亮 |
| 真 SQL 可玩坏 | 每道题重建独立 SQLite 练习库,改坏了下次运行自动恢复 |
| 断言式判题 | 67 Python + 7 SQL 题带真实行为断言,能分辨「没写 / 写错 / 写对」,写错再分「答案错 / 业务逻辑错」 |
| 零构建、零依赖 | 纯静态站,npm start 即跑,无 npm install、无打包器 |
| 自带模型接口(BYOK) | 右上角 ⚙ 可接 OpenAI / DeepSeek / Ollama 本地,走标准 OpenAI 兼容协议,Key 只存浏览器 |
| 昼夜双主题 | 跟随系统偏好,防闪烁(anti-FOUC),一键切换 |
| 63/63 回归测试 | node --test tests/regression.cjs 可复现 |
浏览器
├─ Pyodide (wasm CPython, 自托管) → Python 练习真实执行
├─ SQLite (每题重建) → SQL 练习真实执行
├─ 内嵌 TS 5.9.3 编译器 → TypeScript strict 检查
├─ 隔离 iframe + Worker → JS/TS 安全执行
└─ localStorage / Supabase Auth → 进度本地保存 / 跨设备同步(可选)
↑
纯静态托管(Cloudflare Pages)——无服务端逻辑
每个模块新增出发前衔接课、直接先修导航与进度;词典放到代码之前,概念课不再要求运行示意文字。
新增10模块:AI数学、神经网络、深度学习、NLP、大模型部署、微调、LoRA、QLoRA、知识图谱、RAG。
13道新Python题有行为断言和未完成答案反例;另有概念题、手算、阅读与本机任务。
labs/README.md 提供解压、终端、虚拟环境、实验运行和故障检查步骤。运行 python scripts/build-model-labs.py 生成下载包。
真实GPU微调和真实本地模型服务没有在本次环境实测,课程明确区分原理实验、配置阅读与真实模型实验。课程数量与XP不保证精通,需通过独立修改和项目证据检验。
很多「学编程」卡在两个地方:一是只看不练,代码看着都懂,一写就错;二是练习环境门槛高,装环境、配依赖就把人劝退了。循码 Codepath 想把这两点都压到最低:
- 零安装:打开网页就能跑真实代码,Python/SQL/JS/TS 全部在浏览器内完成,无需任何后端。
- 边学边练:每一节都是「讲解 → 动手 → 运行检查 → 复盘」闭环,练习带真实断言,能区分「写对了」「没写」和「业务写错」。
- 诚实的证据:项目验收和毕业自评要求真实代码 + 运行 + 测试证据,网站只检查填写完整度,不冒充第三方能力认证。
想快速上手请看 使用文档 →;想理解课程结构与内部模块请看 架构说明 →;完整背景见 项目背景 →。
直接打开发布的网站,从“零号训练营”的点击、焦点与安全练习开始。右侧填写代码,点击「运行并检查」。按课程顺序完成讲解、练习与复盘,再进入实战项目。
- 67 个 Python 练习 和 7 个 SQL 练习 使用真实 Pyodide / SQLite 在浏览器中运行;9 个 JavaScript、7 个 TypeScript 在隔离环境执行。首次运行需要联网下载环境。
- 142 个概念或本机指导小节 涵盖开发工具、Java、FastAPI、Spring Boot、Spring AI、Linux、源码阅读与复杂项目工程。网页提供步骤与知识检查,不代替本机编译或项目验收。
- Agent 与多角色基础练习明确使用确定性模拟;真实模型集成在本机项目阶段进行。网站本身没有接入聊天模型;审核中心可运行单文件 JS/TS/Python 与业务断言、提示部分静态风险,不会自动审查整个任意仓库。
- 课程、草稿、笔记、项目检查与毕业自评保存在当前浏览器。用页面底部的「备份学习进度」导出,再在其他浏览器导入。
这是普通静态网站,无需 npm install 或构建。
# 方式一:Node(零依赖,仓库自带脚本)
npm start
# 或手动:node scripts/serve.cjs 4317
# 方式二:Python
cd dist
py -m http.server 4317 --bind 127.0.0.1打开 http://127.0.0.1:4317 。直接双击 HTML 可能受浏览器 Worker 的文件来源限制,因此代码运行需要 HTTP / HTTPS。
node --test tests/regression.cjs # 浏览器课程断言 + 业务逻辑 + 静态规则(当前 63/63)
python tests/exercises.py # 67 Python + 7 SQL 参考实现(74 通过)
python tests/runtime-python.py # 运行时参考 + 反例
python scripts/build-test-bundle.py # 重新生成 dist/codepath-tests.zipnode 与 python 均无需安装依赖:TypeScript 编译器 5.9.3 已附带于 dist/vendor/typescript/(许可见其目录内 LICENSE.txt)。
codepath/
├─ README.md / CHANGELOG.md / CONTRIBUTING.md / LICENSE
├─ package.json # npm start / test 入口(零依赖)
├─ .editorconfig / .gitignore / .nojekyll
├─ docs/
│ ├─ 项目背景.md # 项目缘起、边界、目标
│ ├─ 使用文档.md # 学习者与贡献者操作指南
│ └─ 架构.md # 模块与数据流说明
├─ dist/ # 站点本体(静态)
│ ├─ index.html # 入口
│ ├─ style.css # 桌面 + 手机布局
│ ├─ curriculum.js … new-courses.js / new-projects.js / daily.js # 逐课内容
│ ├─ learning-core.js # 纯业务逻辑(XP/去重/归一/扫描),被页面与测试共享
│ ├─ runner.js / js-runner.js / sandbox.js # 隔离执行器(Pyodide / JS·TS / 不透明 iframe+Worker)
│ ├─ app.js / learning-hub.js / capstones.js / export-dialog.js # 路由、审核、毕业、导出
│ ├─ llm-client.js # 通用模型接口(BYOK,OpenAI 兼容协议)
│ ├─ star-unlock.js # Star 权益解锁(纯前端校验和,开源可审计)
│ ├─ test-report.html # 实测报告
│ ├─ codepath-tests.zip # 可下载测试包(build-test-bundle.py 生成)
│ └─ vendor/typescript/ # 随仓库分发的 TS 5.9.3 编译器
├─ tests/ # Node 回归 + Python 参考实现
└─ scripts/ # 导出 / 打包 / 本地服务脚本
Python 基础 → 数据结构与算法 → SQL 与数据库 → 开发工具与工程基础 → Linux · 从终端到服务排障 → JavaScript · 网页开始行动 → TypeScript · 为代码建立约定 → FastAPI 接口开发 → Java 与面向对象 → Spring Boot 应用开发 → Spring AI 应用集成 → Agent 与检索增强 → 多 Agent 协作 → 智能体系统 · 架构与协作 → GitHub 源码阅读与分析 → AI 代码理解与接管 → 复杂项目的工程能力。
- 课程提供从入门到独立实践的训练路线,不承诺仅凭阅读或打卡就精通全部技术。
- Spring 与模型提供方配置会随版本变化;安装时应核对生成器与文档版本。
- 静态安全扫描是启发式,不是完整漏洞审计或生产安全保证。
- 学习参考代码不是具备鉴权、限流、生产监控等全部能力的商业系统。
内容核对日期:2026-09-22。
本项目按 MIT 许可证 开源。随仓库分发的 TypeScript 编译器保留其原有许可(dist/vendor/typescript/LICENSE.txt)。
如果循码对你有帮助,或者你觉得「浏览器里跑真代码」这件事值得被更多人看到: