CLI 使用#

操作流程#

按安装说明安装平台 wheel。运行 python -m pip install laymesh 即可安装全部功能，也可安装本地 wheel。将安装页的完整示例保存为 figure.lay 后运行：

1laymesh validate figure.lay2laymesh render figure.lay -o figure.pdf

CLI 提供三个命令：

1laymesh validate <file.lay>2laymesh inspect <file.lay> --json3laymesh render <file.lay> -o <output.svg|pdf|png|jpg|tif|webp|bmp|gif|ico|pnm|tga> [--dpi <number>]

python -m laymesh 与 laymesh 等价。源码开发时先运行 cargo build --release --locked -p laymesh-cli，再调用 target/release/laymesh（Windows 为 laymesh.exe），或用 cargo run --release --locked -p laymesh-cli -- 作为命令开头。validate 只检查源文件和素材；render 在检查通过后生成文件。出错时命令返回非零状态，并给出文件、行、列及原因。

inspect --json 输出绘图区、坐标轴映射、变换和警告。三个命令均支持 --warnings show|hide；显式选项优先于环境变量 LAYMESH_WARNINGS，默认 show。隐藏警告不会隐藏错误，也不会删除检查 JSON 中的诊断。

限制与相关主题#

导出格式与分辨率 · 检查与警告

workflow#

本流程的完整源码与可执行验证文件列在功能覆盖清单。组合使用时请遵循本页的输入条件与限制。