hakorune/docs/tools/cli-options.md

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）

使用例

# インタープリターで実行
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