Using workspaceFolders

Unlike VSCode，vim doesn't have workspace support. The solution is resolve workspace folder from opened files.

Resolve workspace folder

A list of file/folder names is used for resolve workspace folder, the patterns could comes from:

• b:coc_root_patterns variable of current buffer.
• rootPatterns specified for language server used for current buffer.
• "coc.preferences.rootPatterns" settings, which default to [".vim", ".git", ".hg", ".projections.json"].

The later one have lower priority, which means it's only used when previous patterns failed to match workspace folder.

When resolve of workspace folder failed, cwd is used for workspaceFolder.

To configure rootPatterns for specified filetype, use autocmd like:

autocmd FileType python let b:coc_root_patterns = ['.git', '.env']

Note workspace folder is resolved from up to down, cwd is checked first when the file is inside cwd,.

Note for performance reason, user's home directory would never considered as workspace folder.

Note since it works by resolve from files, to enable multiple workspace folders, you have to open at least one file of each folders.

Manage workspace folders

Use command :CocList folders to open list of workspace folders, delete and edit actions are supported.

Use command :echo coc#util#root_patterns() to get patterns used for resolve workspace folder of current buffer.

Disable workspace folders support

You can add "disableWorkspaceFolders": true to the configuration section of the language server when you don't want the language server make use of workspaceFolders feature.

Persist workspace folders

Variable g:WorkspaceFolders is used for store current workspace folders, use set sessionoptions+=globals in your vimrc if want to restore workspace folders from session.