VScode插件 环境

 

（如果提示没有找到vscode模块 直接npm  install 就可以了）

1 最新的vscode

2 安装node

3 npm install -g yo generator-code 安装 两个生产插件代码的东西

4 

yo code

来生成我们要的基本代码

 

1. 输入你扩展的名称
2. 输入一个标志（项目创建的文件名称用这个）
3. 输入对这个扩展的描述
4. 输入以后要发布用到的一名称（和以后再发布时候有一个名字是对应上的）
5. 是问你要不要创建一个git仓库用于版本管理
6.  进入项目 安装依赖   npm install
7. 目录说明

 

1. 

package.json 

 

{
	// 插件的名字，应全部小写，不能有空格
	"name": "vscode-plugin-demo",
	// 插件的友好显示名称，用于显示在应用市场，支持中文
	"displayName": "VSCode插件demo",
	// 描述
	"description": "VSCode插件demo集锦",
	// 关键字，用于应用市场搜索
	"keywords": ["vscode", "plugin", "demo"],
	// 版本号
	"version": "1.0.0",
	// 发布者，如果要发布到应用市场的话，这个名字必须与发布者一致
	"publisher": "sxei",
	// 表示插件最低支持的vscode版本
	"engines": {
		"vscode": "^1.27.0"
	},
	// 插件应用市场分类，可选值： [Programming Languages, Snippets, Linters, Themes, Debuggers, Formatters, Keymaps, SCM Providers, Other, Extension Packs, Language Packs]
	"categories": [
		"Other"
	],
	// 插件图标，至少128x128像素
	"icon": "images/icon.png",
	// 扩展的激活事件数组，可以被哪些事件激活扩展，后文有详细介绍
	"activationEvents": [
		"onCommand:extension.sayHello"
	],
	// 插件的主入口
	"main": "./src/extension",
	// 贡献点，整个插件最重要最多的配置项
	"contributes": {
		// 插件配置项
		"configuration": {
			"type": "object",
			// 配置项标题，会显示在vscode的设置页
			"title": "vscode-plugin-demo",
			"properties": {
				// 这里我随便写了2个设置，配置你的昵称
				"vscodePluginDemo.yourName": {
					"type": "string",
					"default": "guest",
					"description": "你的名字"
				},
				// 是否在启动时显示提示
				"vscodePluginDemo.showTip": {
					"type": "boolean",
					"default": true,
					"description": "是否在每次启动时显示欢迎提示！"
				}
			}
		},
		// 命令
		"commands": [
			{
				"command": "extension.sayHello",
				"title": "Hello World"
			}
		],
		// 快捷键绑定
		"keybindings": [
			{
				"command": "extension.sayHello",
				"key": "ctrl+f10",
				"mac": "cmd+f10",
				"when": "editorTextFocus"
			}
		],
		// 菜单
		"menus": {
			// 编辑器右键菜单
			"editor/context": [
				{
					// 表示只有编辑器具有焦点时才会在菜单中出现
					"when": "editorFocus",
					"command": "extension.sayHello",
					// navigation是一个永远置顶的分组，后面的@6是人工进行组内排序
					"group": "navigation@6"
				},
				{
					"when": "editorFocus",
					"command": "extension.demo.getCurrentFilePath",
					"group": "navigation@5"
				},
				{
					// 只有编辑器具有焦点，并且打开的是JS文件才会出现
					"when": "editorFocus && resourceLangId == javascript",
					"command": "extension.demo.testMenuShow",
					"group": "z_commands"
				},
				{
					"command": "extension.demo.openWebview",
					"group": "navigation"
				}
			],
			// 编辑器右上角图标，不配置图片就显示文字
			"editor/title": [
				{
					"when": "editorFocus && resourceLangId == javascript",
					"command": "extension.demo.testMenuShow",
					"group": "navigation"
				}
			],
			// 编辑器标题右键菜单
			"editor/title/context": [
				{
					"when": "resourceLangId == javascript",
					"command": "extension.demo.testMenuShow",
					"group": "navigation"
				}
			],
			// 资源管理器右键菜单
			"explorer/context": [
				{
					"command": "extension.demo.getCurrentFilePath",
					"group": "navigation"
				},
				{
					"command": "extension.demo.openWebview",
					"group": "navigation"
				}
			]
		},
		// 代码片段
		"snippets": [
			{
				"language": "javascript",
				"path": "./snippets/javascript.json"
			},
			{
				"language": "html",
				"path": "./snippets/html.json"
			}
		],
		// 自定义新的activitybar图标，也就是左侧侧边栏大的图标 最合适的大小是28
		"viewsContainers": {
			"activitybar": [
				{
					"id": "beautifulGirl",
					"title": "美女",
					"icon": "images/beautifulGirl.svg"
				}
			]
		},
		// 自定义侧边栏内view的实现
		"views": {
			// 和 viewsContainers 的id对应
			"beautifulGirl": [
				{
					"id": "beautifulGirl1",
					"name": "国内美女"
				},
				{
					"id": "beautifulGirl2",
					"name": "国外美女"
				},
				{
					"id": "beautifulGirl3",
					"name": "人妖"
				}
			]
		},
		// 图标主题
		"iconThemes": [
			{
				"id": "testIconTheme",
				"label": "测试图标主题",
				"path": "./theme/icon-theme.json"
			}
		]
	},
	// 同 npm scripts
	"scripts": {
		"postinstall": "node ./node_modules/vscode/bin/install",
		"test": "node ./node_modules/vscode/bin/test"
	},
	// 开发依赖
	"devDependencies": {
		"typescript": "^2.6.1",
		"vscode": "^1.1.6",
		"eslint": "^4.11.0",
		"@types/node": "^7.0.43",
		"@types/mocha": "^2.2.42"
	},
	// 后面这几个应该不用介绍了
	"license": "SEE LICENSE IN LICENSE.txt",
	"bugs": {
		"url": "https://github.com/sxei/vscode-plugin-demo/issues"
	},
	"repository": {
		"type": "git",
		"url": "https://github.com/sxei/vscode-plugin-demo"
	},
	// 主页
	"homepage": "https://github.com/sxei/vscode-plugin-demo/blob/master/README.md"
}

VS Code默认状况下并不会在启动时立刻执行拓展中的代码。（不会立刻执行插件的功能 需要一些操作来激活执行代码 达到完成功能）

因此，为了使拓展能够被激活，我们需要在package.json文件中定义activationEvents项的内容。例如上例中，activationEvents的定义如下：

activationEvents 定义怎么样激活拓展（插件）代码

...
"activationEvents": [
    "onCommand:extension.sayHello"
],
...

意思是当“onCommand:extension.sayHello”事件被触发之后，拓展会被激活。那么在VS Code中，激活事件都有哪些种类呢？下面我们就来归一下类。
根据文件所使用的语言：onLanguage:${language}
当打开的文件是使用onLanguage所规定的语言时，拓展会被激活。
例如：
 

...
"activationEvents": [
    "onLanguage:python"
]
...

根据所输入的命令：onCommand:${command}
当在onCommand中规定的命令被触发时，拓展会被激活。在上文生成的Hello World模板中，我们就可以看到。
 

...
"activationEvents": [
"onCommand:extension.sayHello"   这里的extension.sayHellow 是命令名字 就和函数名一样 具体命令 是要自己去写的 当触发你写的                            的                 那个命令以后  就会激活这个拓展   也就是onCommand 命令激活的拓展
]
...

根据文件夹：workspaceContains:${toplevelfilename}
 

"activationEvents": [
    "workspaceContains:package.json"
],

 无限制：*
 

...
"activationEvents": [
    "*"
]
...

由于没有限制，因此在VS Code一启动时便会激活该拓展。因此，这种不加以条件限制就激活拓展的方式并不是十分推荐的。大家最好谨慎使用。
Contribution
在package.json文件中的contributes项中，同样包含很多种类。如果需要归类的话，可以分为以下几个类型。
configuration commands keybindings languages debuggers grammars themes snippets
但是本文限于篇幅，将只关注commands和keybindings这两种。

commands

还以上文中的Hello World为例，我们在commands项中定义了命令的title以及title所对应的具体命令。如下所示：

"contributes": {
    "commands": [{
        "command": "extension.sayHello",
        "title": "Hello World"
    }]
},

模板拓展的运行过程了。
1VS Code首先会检测到拓展并且读取拓展的package.json文件

2将package.json文件中的contributes定义的快捷键keybindings或者命令面板输入来触发extension.sayHello命令。
一旦extension.sayHello触发，VS Code会创建一个叫做onCommand:extension.sayHello的激活事件。
与此同时，所有在自己的package.json文件中将activationEvents设置为onCommand:extension.sayHello的拓展会被激活。

激活它去寻找命令对应的回调函数。执行此函数。

//   并且会根据package.json文件中main项的内容，将./out/src/extension.js文件加载到JavaScript VM中。接下来，VS Code会调用在extension.js文件中的active函数，在active函数中，我们需要提供“extension.sayHello”这个函数的具体实现并执行。

此时一旦安装了该拓展，我们就可以在VS Code中的命令面板（我在Mac上的快捷键是Shift+cmd+p）中找到“Hello World”，输入便会触发extension.sayHello这条命令，而上文中的拓展激活事件项activationEvents中如果定义的内容是"onCommand:extension.sayHello"，则激活事件被触发，拓展的代码被激活。

keybindings

当然，和commands对应的，我们还可以通过在package.json中定义keybindings项，通过绑定快捷键的方式触发命令。这样操作起来更加便捷，例如下文中我们自己开发一个插入标准页眉的拓展时，使用的便是绑定快捷键的方式。

"contributes": {
    "keybindings": [{
        "command": "extension.insertHeader",
        "key": "shift+cmd+1",
        "when": "editorTextFocus"  这里的when  是指在什么时候触发 在VScode的不同位置按此键的触发的命令可能会不一样
    }]
},

三、 打包与发布

我们编写完一个插件，总不能要用的时候来运行代码然后来使用吧，而且要分享给别人也不方便啊。有个很low的办法，就是拷贝项目到插件目录，但是这不靠谱吧。所以我们需要一个打包工具叫 vsce 同样的可以用npm来安装，打开cmd执行命令

npm install -g vsce

安装完成后可以用命令窗口 cd 到你的项目目录下去，然后执行命令

vsce publish

来发布到marketplace.visualstudio.com上面去。发布成功后可以在vscode里面用 ext install 来按这个插件。这种做法我个人觉得特别的麻烦，还需要去配置一个token，然后这个token还的找个地方记住，还会过期，而且在发布过程中还得祈祷网络好。所以这里不介绍，有兴趣的自己看这里。那么这里来介绍一个打包成 .vsix 的插件，而且这个插件也可以通过这个页面上传分享。

cd到项目目录下，然后执行命令 vsce package 来打包一个

vsce package

Executing prepublish script 'node ./node_modules/vscode/bin/compile'...

Created: /sample/sample-0.0.1.vsix

我们可以看到执行了这个命令后，再执行一个 script 'node ./node_modules/vscode/bin/compile' 这个命令是在 package.json里面有配置

"scripts": {
    "vscode:prepublish": "node ./node_modules/vscode/bin/compile",
    "compile": "node ./node_modules/vscode/bin/compile -watch -p ./",
    "postinstall": "node ./node_modules/vscode/bin/install"
},

执行完之后再创建了一个sample-0.0.1.vsix，这个就是我们打包好的插件安装包了，只要把这个直接拖到vscode的窗口上，就会提示你安装成功重启vscode，我们重启完之后就使用相关的命令。而且在插件的目录下也多了对应sample的目录。