Skip to content

Debug

Log Panel

Log messages are printed in the dedicated log panel. There are two ways to open the log panel:

  1. Right click on the bottom-left corner of ST and then select Output: AutoSetSyntax.
  2. Run AutoSetSyntax: Toggle Log Panel from the command palette1.

To check whether your rules are being dropped during optimization (e.g., due to wrong names or arguments), (re-)save your plugin/project settings and inspect the log panel for dropped rules messages. Each one says why it could be dropped, in the rule's own words:

never matches: no extension was given
never matches: this Sublime Text is linux_x64, not any of "windows_x64"
always matches: a "threshold" of 0 is met without finding anything

A dropped rule is not an error — a rule that can never match, or always matches, simply doesn't need re-testing on every view. But if one you meant to use shows up here, the reason is what tells you which argument to fix.

Note

Each window has its own log panel. They may have different outputs due to project settings.

Debug Information

Just run AutoSetSyntax: Debug Information from the command palette1.

Tip

The output is designed to be Python-compatible, thus you can format it with a Python formatter like Ruff.

Syntax Rules Summary

Run AutoSetSyntax: Syntax Rules Summary from the command palette1.

Tip

The output is designed to be Python-compatible, thus you can format it with a Python formatter like Ruff.


  1. Command palette: Ctrl+P for Windows/Linux. Cmd+P for macOS. ↩↩↩