MIR optimizations are optimizations run on the MIR to produce better MIR before codegen. This is important for two reasons: first, it makes the final generated executable code better, and second, it means that LLVM has less work to do, so compilation is faster. Note that since MIR is generic (not monomorphized yet), these optimizations are particularly effective; we can optimize the generic version, so all of the monomorphizations are cheaper!
MIR optimizations run after borrow checking. We run a series of optimization
passes over the MIR to improve it. Some passes are required to run on all code,
some passes don't actually do optimizations but only check stuff, and some
passes are only turned on in
optimized_mir query is called to produce the optimized MIR
for a given
DefId. This query makes sure that the borrow checker has
run and that some validation has occurred. Then, it steals the MIR,
optimizes it, and returns the improved MIR.
The list of passes run and the order in which they are run is defined by the
run_optimization_passes function. It contains an array of passes to
run. Each pass in the array is a struct that implements the
The array is an array of
&dyn MirPass trait objects. Typically, a pass is
implemented in its own submodule of the
Some examples of passes are:
CleanupNonCodegenStatements: remove some of the info that is only needed for analyses, rather than codegen.
ConstProp: Does constant propagation
You can see the "Implementors" section of the
MirPass rustdocs for more examples.
MIR optimizations can come in various levels of readiness. Experimental
optimizations may cause miscompilations, or slow down compile times.
These passes are still included in nightly builds to gather feedback and make it easier to modify
the pass. To enable working with slow or otherwise experimental optimization passes,
you can specify the
-Z mir-opt-level debug flag. You can find the
definitions of the levels in the compiler MCP. If you are developing a MIR pass and
want to query whether your optimization pass should run, you can check the
current level using
Optimization fuel is a compiler option (
-Z fuel=<crate>=<value>) that allows for fine grained
control over which optimizations can be applied during compilation: each optimization reduces
fuel by 1, and when fuel reaches 0 no more optimizations are applied. The primary use of fuel
is debugging optimizations that may be incorrect or misapplied. By changing the fuel
value, you can bisect a compilation session down to the exact incorrect optimization
(this behaves like a kind of binary search through the optimizations).
MIR optimizations respect fuel, and in general each pass should check fuel by calling
tcx.consider_optimizing and skipping the optimization if fuel
is empty. There are a few considerations:
- If the pass is considered "guaranteed" (for example, it should always be run because it is
needed for correctness), then fuel should not be used. An example of this is
- In some cases, an initial pass is performed to gather candidates, which are then iterated to
perform optimizations. In these situations, we should allow for the initial gathering pass
and then check fuel as close to the mutation as possible. This allows for the best
debugging experience, because we can determine where in the list of candidates an optimization
may have been misapplied. Examples of this are