API Host OptimizationOptions

OptimizationOptions

编译期优化开关

Compile-time optimization switches

.NET Host API 目录

.NET Host API Directory

概述

Overview

OptimizationOptions 控制优化等级、模块内直接调用、模块常量内联和脚本栈跟踪。通过 EngineOptions.WithOptimization 设置。

OptimizationOptions controls optimization level, same-module direct calls, module-constant inlining, and script stack traces. Set it through EngineOptions.WithOptimization.

属性

Properties

• Default
  默认优化。

  Default optimization.
  var options = OptimizationOptions.Default;

• Level
OptimizeOptions 优化等级。

  OptimizeOptions level.
  builder.Level = OptimizeOptions.Release;

• EnableAutoModuleDirectCall
  自动推断可直接调用的同模块函数。

  Infers direct-callable same-module functions.
  builder.AutoModuleDirectCall = true;

• EnableModuleConstInlining
  内联可证明安全的模块常量读取。

  Inlines proven-safe module-constant reads.
  builder.ModuleConstInlining = true;

• StackTrace
  发射脚本栈跟踪信息。

  Emits script stack-trace data.
  builder.StackTrace = true;

OptimizationOptionsBuilder 与 With... 方法

OptimizationOptionsBuilder and With... Methods

Parameters:

• 各 With... 方法接收与同名属性对应的值。

  Each With... method takes the value for its matching property.

Returns

同一 Builder。

The same builder.

var options = EngineOptions.Default.WithOptimization(builder => builder
    .WithLevel(OptimizeOptions.Release)
    .WithAutoModuleDirectCall(true)
    .WithModuleConstInlining(false)
    .WithStackTrace(true));

常量内联会降低热更新后读取同一模块常量的动态可观察性；需要该语义时关闭它。

Constant inlining reduces dynamic observability of same-module constants after hot patching; disable it when that behavior matters.