本文邀請cheeqi來回答GuideGuide5.0.16輔助線插件，讓他手把手教你如何開發(fā)一個爆款VS Code插件！

vscode 插件的形態(tài)和一個 npm 包非常相似，需要在項目的根目錄添加 package.json，并且在其中增加一些 vscode 獨家的設置GuideGuide5.0.16輔助線插件。其中最主要的設置是 Activation Events(插件的激活時機) 和 contribution points (插件的能力)。接下來我們主要看看這兩個配置具體是什么意思。

聲明插件的激活時機 Activation Events我將 vscode 的生命周期簡單描述為下圖GuideGuide5.0.16輔助線插件。下面會做進一步解釋。

[ vscode 插件生命周期（轉(zhuǎn)載請注明作者 cheeqi） ]

activate() 函數(shù) deactivate() 函數(shù)

可以看到生命周期中最終要的兩個節(jié)點就是activate函數(shù)和deactivate函數(shù)GuideGuide5.0.16輔助線插件。這兩個函數(shù)需要在插件 npm 模塊的入口文件 export 出去給 vscode 主動調(diào)用。

其中，activate 會在 vscode 認為合適的時機調(diào)用，并且在插件的運行周期內(nèi)只調(diào)用一次GuideGuide5.0.16輔助線插件。因此在 activate 函數(shù)中開始啟動插件的邏輯，是一個非常合適的時機。

deactivate 函數(shù)會在插件卸載之前調(diào)用，?cè)绻愕男遁d邏輯中存在異步操作，那么只需要在deactivate 函數(shù)中 retuen 一個 promise 對象，vscode 會在 promise resolve 時才正式將插件卸載掉GuideGuide5.0.16輔助線插件。

onXxxx Activation Events可以看到在activate函數(shù)之前，還有onLanguage等事件的描述，實際上這些就是聲明在插件 package.json 文件中的 Activation EventsGuideGuide5.0.16輔助線插件。聲明這些 Activation Events 后，vscode 就會在適當?shù)臅r機回調(diào)插件中的 activate函數(shù)。vscode之所以這么設計，是為了節(jié)省資源開銷，只在必要的時候才激活你的插件。當然，?cè)绻愕牟寮浅Ｖ匾偛幌Ｍ谀硞€事件之后才被激活，你可以聲明Activation Events為*這樣 vscode 就會在啟動的時候就開始回調(diào) activate函數(shù)。

插件的具體邏輯插件中的具體邏輯 vscode 沒有做任何限制，你可以通過調(diào)用vscdoe提供的各種 api 對其進行擴充GuideGuide5.0.16輔助線插件。不過需要注意的是，出于性能和移植性考慮，vscode不允許開發(fā)者直接操作dom。

關于vscode 的 api 可以參考

021yin.com /api/references/vscode-api 這是微軟根據(jù) vscode 的 d.ts 文件生成的文檔

舉個例子接下來我們來看幾個插件的 Activation Events 聲明

超越鼓勵師 申明了 onCommand:ycy.showReminderView 和 * GuideGuide5.0.16輔助線插件，其實我們都知道只聲明后一個就足夠了

vuter 申明了 onLanguage:vue 所以他會在用戶打開 vue 語言文件時被激活

vscode-icons 是一個純主題插件GuideGuide5.0.16輔助線插件，聲明的是 *

GitLens 需要覆蓋所有的文件GuideGuide5.0.16輔助線插件，并且在vscode啟動時就需要激活，他的聲明是 *

021yin.com /api/references/activation-events

聲明插件的貢獻點 contribution points

需要在 package.json 中聲明的另一個重要字段就是 contribution pointsGuideGuide5.0.16輔助線插件。 contribution points描述了當前插件支持哪些能力，以及對應能力的配置。

由于 vscode 禁止直接操作dom，往 UI 中插入功能的正確方式是聲明貢獻點GuideGuide5.0.16輔助線插件。下圖列出了 vscode 支持的所有貢獻點。

[ 目前 vscode 支持的貢獻點 ]

舉個例子

接下來我們來看幾個插件的 contribution points 聲明

超越鼓勵師 支持通過 commands 觸發(fā)楊超越的提醒GuideGuide5.0.16輔助線插件，同時可以配置提醒出現(xiàn)的時機，因此包括 commands / configuration

vuter 主要為 vue 文件提供語言支持GuideGuide5.0.16輔助線插件，可以看到他提供的 contribution points 比較廣，包括 commands / breakpoints / languages / grammars / configuration

vscode-icons 已支持主題為主GuideGuide5.0.16輔助線插件，他提供了 iconThemes / commands / configuration

GitLens 是對vscode git 功能的增強GuideGuide5.0.16輔助線插件，所以他的插入點集中在 UI 上的能力 configuration / commands / menus /resourceLabelFormatters / viewsContainers / views

021yin.com /api/references/contribution-points

編程語言支持那么GuideGuide5.0.16輔助線插件，要怎么給 vscode 增加一門新的編程語言支持呢？

就像之前說的，vscode 主要支持兩類編程語言支持： 聲明類語言特性主要描述了代碼高亮、代碼片段等輕量級需要實時給出響應的語言特性支持；而程序類語言特性只要提供更加高級的跳到定義、查找引用、hover提示等對實時性要求不高，而且需要大量計算的語言能力GuideGuide5.0.16輔助線插件。因此前者更加適合在 IDE 的主線程進行處理，而后者可以考慮拆分到其他線程甚至服務中進行計算。

聲明類語言特性（基本支持）

下面主要以語法高亮為例子介紹聲明式語言支持GuideGuide5.0.16輔助線插件。

[ 從手寫 paser 到 TextMate ]

在最初，微軟的工程師們?yōu)閣eb開發(fā)中常見的開發(fā)語言都手寫了 paserGuideGuide5.0.16輔助線插件。這類 paser 執(zhí)行效率很高，但對開發(fā)者的能力要求也比較高，不太適合未來的插件擴展。從 vscode 1.8 版本開始，微軟引入了 TextMate 的高亮語法，并逐步將原有的手寫 paser 切換到這種語法上。

[ TextMate 官網(wǎng) ]

TextMate 本身是 mac 下的一個文本編輯器，vscode 借用了他對語言高亮文本的定義方式GuideGuide5.0.16輔助線插件。TextMate語法的本質(zhì)是用一個 json 文件來描述語言中的 token 和結(jié)構(gòu)，當然為了方便，也可以改用 YAML 并編譯成json。

順便一提，而 TextMate 語法使用的是 oniguruma 庫來解析正則表達式，oniguruma 中支持一些 js 引擎目前還不支持的正則特性，因此在 vscode 中使用了一個 oniguruma 的 c++ 模塊來加速正則表達式解析速度GuideGuide5.0.16輔助線插件。

另外，為了方便開發(fā)者編寫語法高亮插件，vscode還提供了一個 yomen 模板用于生成插件基本目錄結(jié)構(gòu)，以及一個名為 inspectTMScopes 的調(diào)試器查看詞法分析的結(jié)果GuideGuide5.0.16輔助線插件。

[ vscode 提供的 yomen 模板 ]

[ inspectTMScopes ]

除了語法高亮外GuideGuide5.0.16輔助線插件，vscode還支持這些特性：注釋切換、括號定義、自動閉合、Auto surrounding、代碼折疊、word Pattern、縮進規(guī)則等，詳見

021yin.com /api/language-extensions/language-configuration-guide