插件指南

当你已经在 Hello World 示例中学到了 VS Code 插件 API 的基础后，接下来就该亲自做一个插件了。插件功能一章中介绍了插件的高级功能，向你展示了插件都能做那些事。而本章将提供详细的代码指南和示例列表，向你解释如何来使用具体的 VS Code API。

在每一篇指南或示例中，你都可以找到：

指南与示例

这些是 VS Code 官方网站上的指南，包含 VS Code API 和 Contribute 配置项。不要忘记参考用户体验指南，你可以从中学到创建一个插件过程中，在用户界面上的最佳实践。

VS Code 官方网站上的指南	API & Contribute 配置项
命令	commands
颜色主题	contributes.themes
文件图标主题	contributes.iconThemes
软件图标主题	contributes.productIconThemes
树形结构视图	window.createTreeView window.registerTreeDataProvider TreeView TreeDataProvider contributes.views contributes.viewsContainers
Webview	window.createWebviewPanel window.registerWebviewPanelSerializer
自定义编辑器	window.registerCustomEditorProvider CustomTextEditorProvider contributes.customEditors
虚拟文档	workspace.registerTextDocumentContentProvider commands.registerCommand window.showInputBox
虚拟工作区	workspace.fs capabilities.virtualWorkspaces
信任工作区	workspace.isTrusted workspace.onDidGrantWorkspaceTrust capabilities.untrustedWorkspaces
任务提供者	tasks.registerTaskProvider Task ShellExecution contributes.taskDefinitions
版本控制	workspace.workspaceFolders SourceControl SourceControlResourceGroup scm.createSourceControl TextDocumentContentProvider contributes.menus
调试器插件	contributes.breakpoints contributes.debuggers debug
Markdown 插件	markdown.previewStyles markdown.markdownItPlugins markdown.previewScripts
插件测试	TestController TestItem
自定义数据插件	contributes.html.customData contributes.css.customData

这里是一个附加的示例列表，来自 VS Code 示例插件仓库。

示例仓库	API & Contribute 配置
Webview 示例	window.createWebviewPanel window.registerWebviewPanelSerializer
状态栏示例	window.createStatusBarItem StatusBarItem
树形结构视图示例	window.createTreeView window.registerTreeDataProvider TreeView TreeDataProvider contributes.views contributes.viewsContainers
任务提供者示例	tasks.registerTaskProvider Task ShellExecution contributes.taskDefinitions
多根节点示例	workspace.getWorkspaceFolder workspace.onDidChangeWorkspaceFolders
代码补全提供者示例	languages.registerCompletionItemProvider CompletionItem SnippetString
文件系统提供者示例	workspace.registerFileSystemProvider
编辑器装饰器示例	TextEditor.setDecorations DecorationOptions DecorationInstanceRenderOptions ThemableDecorationInstanceRenderOptions window.createTextEditorDecorationType TextEditorDecorationType contributes.colors
本地化示例
终端示例	window.createTerminal window.onDidChangeActiveTerminal window.onDidCloseTerminal window.onDidOpenTerminal window.Terminal window.terminals
Vim 示例	commands StatusBarItem window.createStatusBarItem TextEditorCursorStyle window.activeTextEditor Position Range Selection TextEditor TextEditorRevealType TextDocument
版本控制示例	workspace.workspaceFolders SourceControl SourceControlResourceGroup scm.createSourceControl TextDocumentContentProvider contributes.menus
注释 API 示例
文档编辑示例	commands
起步示例	contributes.walkthroughs
测试插件	TestController TestItem

这里是一些语言插件的示例：

示例	VS Code 官网上的指南
代码块示例	language-extensions/snippet-guide	contributes.snippets
语言配置示例	language-extensions/language-configuration-guide	contributes.languages
语言服务协议实例	language-extensions/language-server-extension-guide
语言服务协议日志流示例	N/A
语言服务协议多根节点服务示例	https://github.com/microsoft/vscode/wiki/Adopting-Multi-Root-Workspace-APIs#language-client--language-server (GitHub repo wiki)
语言服务协议 Web 插件示例	language-extensions/language-server-extension-guide