60 lines
2.0 KiB
Markdown
60 lines
2.0 KiB
Markdown
# Nyash CLI Options Quick Reference
|
||
|
||
最終更新: 2025-08-23
|
||
|
||
## 基本
|
||
- `file`: 実行するNyashファイル（位置引数）
|
||
- `--backend {interpreter|vm|llvm}`: 実行バックエンド選択（既定: interpreter）
|
||
- `--debug-fuel {N|unlimited}`: パーサーのデバッグ燃料（無限ループ対策）
|
||
|
||
## MIR関連
|
||
- `--dump-mir`: MIRを出力（実行はしない）
|
||
- `--verify`: MIR検証を実施
|
||
- `--mir-verbose`: 詳細MIR出力（統計など）
|
||
|
||
## VM関連
|
||
- `--vm-stats`: VM命令統計を有効化（`NYASH_VM_STATS=1`）
|
||
- `--vm-stats-json`: VM統計をJSONで出力（`NYASH_VM_STATS_JSON=1`）
|
||
|
||
## GC
|
||
- `--gc {auto|rc+cycle|minorgen|stw|rc|off}`: GCモード（既定: `auto` → rc+cycle）
|
||
- `rc+cycle`: 参照カウント + 循環回収（推奨・安定）
|
||
- `minorgen`: 高速向けの軽量世代別（Gen‑0移動、上位非移動）
|
||
- `stw`: 検証用の非移動Mark‑Sweep（開発者向け）
|
||
- `rc`: 循環回収なしのRC（比較用）
|
||
- `off`: 自己責任モード（循環はリーク）
|
||
- 関連ENV
|
||
- `NYASH_GC_MODE`（CLIが優先）
|
||
- `NYASH_GC_METRICS` / `NYASH_GC_METRICS_JSON`
|
||
- `NYASH_GC_LEAK_DIAG` / `NYASH_GC_ALLOC_THRESHOLD`
|
||
- 詳細: `docs/reference/runtime/gc.md`
|
||
|
||
## WASM/AOT
|
||
- `--compile-wasm`: WATを出力
|
||
- `--compile-native` / `--aot`: AOT実行ファイル出力（要wasm-backend）
|
||
- `--output, -o FILE`: 出力先を指定
|
||
|
||
## ベンチマーク
|
||
- `--benchmark`: バックエンド比較ベンチを実行
|
||
- `--iterations N`: ベンチ実行回数（既定: 10）
|
||
|
||
## 使用例
|
||
```bash
|
||
# インタープリターで実行
|
||
nyash program.hako
|
||
|
||
# VMで実行 + 統計をJSON出力
|
||
nyash --backend vm --vm-stats --vm-stats-json program.hako
|
||
|
||
# MIRを出力
|
||
nyash --dump-mir --mir-verbose program.hako
|
||
|
||
# ベンチマーク
|
||
nyash --benchmark --iterations 100
|
||
```
|
||
|
||
詳細は `docs/reference/architecture/execution-backends.md` も参照してください。
|
||
|
||
## 参考: `nyash --help` スナップショット
|
||
- docs/tools/nyash-help.md
|