使用说明

d2mcpp是一个强调动手实践的现代C++核心语言特性教程项目。基于xlings(d2x)工具搭建了一套编译器驱动开发模式的代码练习, 可以自动化的检测练习代码的状态和跳转到下一个练习...

0. 获取并准备环境

支持的发布平台：Linux x86_64、macOS 14+ Apple Silicon、Windows x86_64（Windows PowerShell 5.1+）。mcpp 管理 C++ 工具链，Visual Studio 为可选项。当前课程所用 d2x Release 尚未覆盖 Linux ARM64。编辑器可自行选择，课程不会强制安装。

第一步：获取课程（建议先 fork，用 git 保存自己的练习进度）：

git clone https://github.com/mcpp-community/d2mcpp.git
cd d2mcpp

第二步：准备环境。 脚本安装 xlings 2026.10.18.1 及 .xlings.json 声明的版本（mcpp 2026.10.17.1、d2x 2026.10.21.1、mdBook 0.4.43），构建并检查 Provider。首次构建可能需要几分钟。

Linux / macOS：

bash scripts/setup.sh
export PATH="$HOME/.xlings/subos/current/bin:$PATH"

Windows PowerShell：

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\setup.ps1
$env:Path = "$env:USERPROFILE\.xlings\subos\current\bin;$env:Path"

PATH 命令让当前终端立即找到工具；安装后重新打开终端即可供后续会话使用。准备脚本可重复执行，不会改动练习文件或学习进度。

可选：通过已有 d2x 下载课程

如果已经安装 d2x，可以使用以下方式。下载后在课程目录执行 xlings install -y，按 .xlings.json 安装依赖，无需提前安装 mcpp 或选择 latest。

d2x install d2mcpp
cd d2mcpp
xlings update
xlings install -y

之后继续第二步的准备脚本。更新课程后同样按项目配置安装依赖。

第三步：验证环境并开始练习：

mcpp test -p solutions       # 参考答案应全部通过（当前 52 份）
d2x checker                  # 编辑 -> 保存 -> 自动检测 -> 推进
d2x status                   # 进度总览

未完成的练习报错是预期行为，参考答案必须全绿。Provider 错误或链接路径含 /nonexistent/ 属于环境问题，请查看诊断与恢复步骤。git pull 后重新运行准备脚本，让更新后的版本配置生效。

也可使用 mcpp test -p src/cpp11 直接练习某一章。更多操作见使用说明。

本地电子书

可以在项目目录执行d2x book命令, 打开本地文档(包含使用说明和电子书)

d2x book

练习代码自动检测

进入项目目录d2mcpp运行checker命令, 进入练习代码自动检测程序

d2x checker

查看学习进度

只读的进度总览,按章节聚合,不进入练习模式

d2x status

原生模式(可选)

每个 C++ 标准目录都是真实的 mcpp 工程,练习就是它的 tests/——不经过 d2x,直接用 mcpp 也能练:

mcpp test                           # 你的完整进度表(动手前全红, 那就是起点)
mcpp test -p src/cpp11              # 整个 cpp11 的进度表(哪题绿哪题红)
mcpp test -p src/cpp11 03-trailing  # 只跑名字匹配的练习

同步最新的练习代码

项目处于持续更新阶段,更新使用 git(注意先保存/提交你已修改的练习):

git pull

使用d2x checker进入自动化代码练习环境后, 工具会自动定位打开对应的练习代码文件, 并在控制台输出提示编译器的错误及提示信息。一般检测程序分两个检测阶段: 第一个是编译期检测, 即你需要通过练习代码中的提示信息和控制台编译器的报错, 修复代码的编译错误; 第二个是运行时检测, 即当前代码运行时是否能通过所有检查点。当修复编译错误并通过所有检查点时, 控制台就会显示当前练习通过并提示你进入下一个练习

代码练习文件示例

// d2mcpp: https://github.com/mcpp-community/d2mcpp
// license: Apache-2.0
// file: src/intro/tests/hello-mcpp.cpp
//
// Exercise/练习: 自动化代码练习使用教学
//
// Tips/提示:
//    这是一个「练习即测试」的自动化代码练习项目。两种使用方式任选:
//
//      d2x checker              引导模式: 自动检测,通过后进入下一题
//      mcpp test -p src/intro       原生模式: 直接使用 mcpp 运行, 测试报告即学习进度
//
//    你需要根据控制台的报错和提示信息修改代码。约定只有三个:
//
//      - D2X_YOUR_ANSWER: 填空占位符 —— 用正确的代码替换它。它不是宏,
//        只是一个没人定义的名字, 所以编译器会指着它报错, 那就是要填的地方
//      - d2x::check / d2x::check_eq: 运行时检查点, 修复代码让所有检查通过
//        (不能直接删除检查点)
//      - d2x::wait(): 练习之间的路障 —— 读完这一课, 删掉它才算真正完成
//
// Auto-Checker/自动检测命令:
//
//   d2x checker hello-mcpp
//

import std;
import d2x;

// 修改代码时可以观察到控制台"实时"的变化

int main() {

    std::cout << "hello, mcpp!" << std:endl; // 0.修复这个编译错误

    int a = 1.1; // 1.修复这个运行时错误, 修改int为double, 通过检查

    d2x::check_eq(a, 1.1, "a == 1.1"); // 2.运行时检查点, 需要修复代码通过所有检查点(不能直接删除检查点代码)

    D2X_YOUR_ANSWER b = a; // 3.修复这个编译错误, 给b一个合适的类型

    d2x::check_eq(b, 1, "b == 1"); // 4.运行时检查点2

    d2x::wait(); // 5.删除或注释掉这一行, 进入下一个练习(项目正式代码练习)

    return 0;
}

控制台输出及解释

🌏Progress: [>----------] 0/52 -->> 显示当前的练习进度

[Exercise: hello-mcpp] -->> 当前的练习名

❌ Error: Compilation/Running failed for src/intro/tests/hello-mcpp.cpp -->> 显示检测状态

 The code exist some error!

---------Output--------- - 编译/运行输出信息
❌ | a == 1.1 (1 == 1.1)  --> src/intro/tests/hello-mcpp.cpp:41 -->> 错误提示及位置(41行)
🚧 | Delete the d2x::wait() to continue  --> src/intro/tests/hello-mcpp.cpp:47


AI-Tips-Config: https://xlings.d2learn.org/documents/d2x/intro.html -->> AI提示(需要配置大模型的key, 可不使用)

---------E-Files---------
src/intro/tests/hello-mcpp.cpp -->> 当前检测的文件
-------------------------

Homepage: https://github.com/openxlings/xlings

3.配置项目(可选)

配置语言

编辑项目配置文件.d2x.json中的lang属性, zh对应中文, en对应英文

{
    "version": "0.1.1",
    "buildtools": "mcpp run -q -p d2x/buildtools --",
    "lang": "en",  < -- 修改这里
    ...
}

自定义编辑器 - 以nvim编辑器为例

如果你希望使用 Neovim 编辑器并获得 LSP（clangd）支持, 可以按如下步骤进行配置

1.编辑项目配置文件.d2x.json中的editor字段, 设置为nvim (或zed)

{
    "buildtools": "mcpp run -q -p d2x/buildtools --",
    "editor": "nvim",
    ...
}

未配置时按 $VISUAL → $EDITOR → code 回退;支持 {file} 占位符;显式配空串表示关闭自动打开。

2.在项目根目录运行一键依赖安装和环境配置命令

xlings install

3.在项目目录, 重新运行检测命令 d2x checker 就会使用nvim打开对应练习文件，并具备练习自动跳转/切换功能

注: nvim编辑器下的"实时检测功能"的触发时机, 将会对应到 :w 命令. 即修改代码后, 在nvim的命令行模式对文件进行保存(:w)时, d2x就会更新检测结果

4.资源于交流

交流群(Q): 167535744

教程讨论版块: https://forum.d2learn.org/category/20

xlings: https://github.com/openxlings/xlings

教程仓库: https://github.com/mcpp-community/d2mcpp

教程视频合集: https://space.bilibili.com/65858958/lists/5208246

首次启动准备与版本核对

d2x install 会安装下载课程所声明的项目依赖。通过 Git 更新后，重新运行准备脚本以应用版本变化。在课程目录执行 d2x --version，与 .xlings.json 对照；仅更新全局工具不能证明项目实际使用的版本。

checker 在第一题之前显示准备信息。首次 Provider 启动的总期限为 900 秒，后续调用的空闲期限为 120 秒；准备提示不会延长期限。失败时保留 .d2x/provider.stdout.log、.d2x/provider.stderr.log 与命令输出。启动和传输错误会非零退出；未完成练习的 fail 判定属于预期行为。

d2mcpp | 动手学现代C++核心语言特性