Files
marqdo/doc/dev-setup.md
T
cflmyandCursor 7dfa161422 Document proxy-7890 push fallback for git network failures
Records the working one-shot command (proxy + larger postBuffer) used
when direct push fails with curl 35/56 connection resets.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-24 14:56:32 +08:00

3.2 KiB
Raw 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 tests/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:7890"
$env:HTTP_PROXY="http://127.0.0.1:7890"
cargo build

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

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

3.5 Git 推送(遇网络失败时使用代理)

直连 git push 偶尔会报 RPC failed; curl 35 Recv failure: Connection reset by peer 或 curl 56(远端挂断,常见于数据包稍大时)。此时通过本机代理 7890 推送:

# Linux/macOS(本机 clash 监听 127.0.0.1:7890)
git -c http.proxy=http://127.0.0.1:7890 -c http.postBuffer=524288000 push origin main

要点:

  • 代理可用性先探测:curl -x http://127.0.0.1:7890 -o /dev/null -w "%{http_code}\n" https://github.com,返回 200 再推。
  • http.postBuffer=524288000(500 MB)用于规避推送大包被断开(curl 56);两个 -c 可叠加。
  • 该命令一次性生效,不写死仓库配置。若想长期默认走代理,可执行:
    git config http.proxy http://127.0.0.1:7890
    git config http.postBuffer 524288000
    
  • 若是别的代理端口,把 7890 换成实际端口(如 Windows 示例里 $env:HTTPS_PROXY 的同款端口)。

4. 目录约定

路径 含义
src/lex 行分类 / 词法(自研)
src/parse 递归下降语法
src/diagnostics 诊断
tests/ 金样例 + 集成测试(structure / keywords / errors)
public/ 用户可执行文档(无 errors)
spike/ 旧 Python 风险探测,非运行时依赖
doc/ 设计与路线图

5. 下一里程碑

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