Files
marqdo/doc/dev-setup.md
T
cflmyandCursor ac0a3fbced Add view, positional args, errors gold, and bytecode backend.
Reorganize examples into structure/keywords/errors, launch marqdo view for AST-backed browsing, and ship an M5 stack VM selectable via --backend.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-04 12:30:40 +08:00

2.1 KiB
Raw Permalink Blame History

开发环境配置(Rust 参考解释器)

状态 M0
相关 dependencies.md · interpreter.md

1. 必备软件

软件 要求 检查
Rust + Cargo stable,建议 ≥ 1.81(本机验证过 1.81) rustc --version / cargo --version
Git 任意近期版本 git --version

安装 Rust(若尚未安装):

  • 官方:https://rustup.rs/
  • Windows:下载 rustup-init.exe,按提示安装后重新打开终端

本仓库可选 rust-toolchain.toml(钉 1.81.0)。若本机无 rustup、但已有匹配的 rustc/cargo,也可直接开发。

不需要: Flex、Bison、LLVM、Node/npm(实现栈为 Rust)。


2. 获取代码与构建

git clone https://github.com/cflmy/marqdo.git
cd marqdo

cargo build
cargo test
cargo run -- run examples/structure/hello.mq.md

当前 M0:run 会读入文件并明确报错「evaluation not implemented」(脚手架,非静默假成功)。

若 cargo build 报 edition2024 / 过新 crate:仓库已对 clap 等做兼容钉扎(见 Cargo.toml);请使用附带的 Cargo.lock,勿盲目 cargo update 到最新 major。


3. 推荐组件

rustup component add rustfmt clippy   # 若使用 rustup
cargo fmt
cargo clippy --all-targets

代理下拉 crate(可选,与 git 推送类似):

# Windows PowerShell 示例
$env:HTTPS_PROXY="http://127.0.0.1:7897"
$env:HTTP_PROXY="http://127.0.0.1:7897"
cargo build

或配置 %USERPROFILE%\.cargo\config.toml:

[http]
proxy = "http://127.0.0.1:7897"

4. 目录约定

路径 含义
src/lex 行分类 / 词法(自研)
src/parse 递归下降语法
src/diagnostics 诊断
examples/ 金样例(宪法)
spike/ 旧 Python 风险探测,非运行时依赖
doc/ 设计与路线图

5. 下一里程碑

见 interpreter.md:M1 词法·行分类与最小 AST。