Guides

First-run setup

1. Install Sublime Text 4, Build 4200, then use File, Open Folder on the project root so Goto Anything can index it.
2. Save a project once the folders look right. Project switch restores tabs and unsaved buffers.
3. Keep overrides in Preferences, Settings, user overlay so an upgrade does not erase them.
4. If you need packages, add Package Control from the Command Palette and only keep packages you intend to use.

Common problems

wrap_lines does not follow newer ruler settings

Build 4200 fixed wrap_lines not understanding newer ruler settings. Update to the current build if an older copy still shows the old wrap behavior.

Find field does not expand for multi-line queries

Build 4192 fixed the find field not expanding with multi-line search queries.

CPU stays high after startup

Indexing large trees is the usual cause. Exclude generated folders and avoid opening a drive root. GPU rendering should use less power than before, but a bad GPU driver can still be turned off from the Command Palette.

A shortcut does nothing

Open Preferences, Key Bindings and search for the command. An operating-system shortcut may be taking the same keys.

Session did not restore

Hot exit writes unsaved buffers when the app closes. If the process was force-killed, open the project file again.

Best practices

Keep generated output out of the indexed folder. Learn Goto Anything, the Command Palette, Ctrl+D and Tab Multi-Select before adding packages. See the features page before replacing a built-in tool.

Antivirus warnings explained

1. Note the exact file path in the alert.
2. Compare its hash with the published digest once that digest exists.
3. If the hash matches, restore the file from quarantine and add a narrow exclusion for that path only.
4. If the hash does not match, delete the file and download again from this site.
5. Do not turn the scanner off for the whole disk.