Microsoft Visual Studio Code 扩展示例项目指南

目录结构及介绍

在克隆或下载了 microsoft/vscode-extension-samples 仓库之后，您将看到一系列的子目录，每一个都代表了一种不同的扩展样例。以下是一些主要的样本及其说明：

子目录概览

• base-sample: 基础扩展模板。
• authenticationprovider-sample: 认证提供者示例，展示了如何实现自定义身份验证。
• basic-multi-root-sample: 多根工作区支持的基本示例。
• call-hierarchy-sample: 调用层次结构提供器示例，用于展示调用关系。
• chat-sample: 一个聊天扩展的简单实例。
• code-actions-sample: 代码操作示例，演示如何建议并执行编辑操作。
• codelens-sample: CodeLens 提供程序示例。
• comment-sample: 评论API示例。
• completions-sample: 自动补全示例。
• configuration-sample: 配置项示例，演示如何读取和写入设置。
• contentprovider-sample: 内容提供程序示例，用于提供自定义文本视图。
• custom-data-sample: 定制数据存储扩展示例。
• custom-editor-sample: 自定义编辑器示例。
• decorator-sample: 编辑器装饰器示例。

所有这些示例提供了从基本到高级的扩展开发指导，涵盖了VS Code API的不同方面。

启动文件介绍

对于大多数的扩展示例而言，main.js 或 extension.js（取决于语言）是主要的入口点，在这里注册所有的激活事件和贡献点。以 base-sample 为例，其 extension.js 中包含了以下核心部分:

// extension.js 示例
let vscode = require('vscode');
function activate(context) {
	// Register commands, event listeners, etc.
	let disposable = vscode.commands.registerCommand('extension.helloWorld', function () {
		vscode.window.showInformationMessage('Hello World!');
	});
	context.subscriptions.push(disposable);
}

exports.activate = activate;

在这个例子中，我们导入 vscode 模块，定义了一个激活函数 activate() ，并在其中注册了一个命令。这个命令被绑定到 extension.helloWorld 这个ID上，当该命令被调用时，它会在VS Code的消息面板显示一条信息。

记住，实际的启动文件可能因项目而异，但通常它们遵循类似的主题，即定义 activate() 函数来初始化并设置所有的特性。

配置文件介绍

通常，在VS Code扩展中进行配置的主要方式是在 .vscode/launch.json 文件内指定调试配置。此外，package.json 文件是扩展的核心描述性文件之一，它不仅描述了扩展本身的信息，还指定了激活条件以及贡献到VS Code的各种功能，如命令、菜单项等。

例如，考虑 package.json 中的一个片段，它指明了扩展的元信息和激活条件:

{
	"name": "example-extension",
	"displayName": "Example Extension",
	"description": "A simple example VS Code extension.",
	"version": "0.0.1",
	"activationEvents": [
		"*"
	],
	"main": "./out/extension.js",
	"contributes": {
		"commands": [
			{
				"command": "extension.helloWorld",
				"title": "Say Hello World"
			}
		]
	},
	"scripts": {
		"vscode:prepublish": "npm run compile",
		"compile": "tsc -p ./",
		"watch": "tsc -w -p ./"
	},
	"engines": {
		"vscode": "^1.47.0"
	},
	"categories": [
		"Other"
	],
	"dependencies": {
		"vscode": "^1.47.0"
	}
}

上述JSON内容解释了扩展是如何在VS Code环境中识别和启用的。它也指示了编译步骤和其他必要的依赖。通过阅读各个扩展的 package.json 文件，可以了解其具体的功能和配置细节。