File Navigation and File Management

Goto Anything

Use Goto Anything to navigate your project’s files swiftly. (More about projects later.)

To open Goto Anything, press Ctrl+P. As you type into the input area, all file names of files open within the editor (and of files in added folders too) will be searched, and a preview of the best match will be shown. This preview is transient; that is, it won’t become the actual active view until you perform some operation on it. Transient views go away when you press Esc. You will see transient views in other situations too.

Goto Anything lives up to its name—there’s more to it than searching files:

To perform a fuzzy text search, append # and keep typing, like so:

isl#trsr

This makes Sublime Text perform a fuzzy search for trsr in files whose name loosely matches isl. For example, you could find the word treasure inside a file named island.txt.

To perform a fuzzy search quickly in the active view, you can press Ctrl+;.

By the way, fuzzy searches can detect transposed characters for clumsy fingers.

And there’s more:

To search symbols in the active view, press Ctrl+R. As in the case of #, the @ operator can be used after file names too.

To go to a line number, press Ctrl+G. Again, the operator : can be used after file names, just as # and @.

Note that searching for symbols will only work if the active file type has symbols defined for it. Symbols are defined in .tmLanguage files.

Projects

Projects group sets of files and folders to keep your work organized. Set up a project by adding folders in a way that suits you, and then save your new configuration.

To save a project, go to Project | Save Project As....

To switch projects quickly, press Ctrl+Alt+P.

Project data is stored in JSON files with a .sublime-project extension. Wherever there’s a .sublime-project file, you may find one or more .sublime-workspace files. Workspaces are explained later.

Project files can define settings specific to that project. More information in the official documentation.

You can open a project from the command line by passing the .sublime- project file as an argument to the Sublime Text executable.

Project files are meant to be committed to source code repositories.

Workspaces

Workspaces can be seen as different views into the same project. For example, you may want to have only a selected few files open while working on Feature A. Or perhaps you use a different pane layout when you’re writing tests, etc. Workspaces help in these situations.

**Workspaces behave very much like projects. To create a new workspace, select **Project | New Workspace for Project. To save the active workspace, select **Project | Save Workspace As....

Workspaces data is stored in JSON files with the .sublime-workspace extension.

Contrary to .sublime-project files, .sublime-workspace files are not meant to be shared or edited manually. Never commit .sublime-workspace files into a source code repository.

To switch between different workspaces, use Ctrl+Alt+P, exactly as you do with projects.

As with projects, you can open a workspace from the command line by passing the desired .sublime-workspace file as an argument to the Sublime Text executable.

Panes

Panes are groups of views. In Sublime Text you can have multiple panes open at the same time.

To create a new pane, press Ctrl+K, Ctrl+Up. To close a pane, press Ctrl+K, Ctrl+Down.

Further pane management commands can be found under View | Layout and related submenus.