导语：VSCode作为微软推出的编辑器，在这几年逐渐被越来越多的人接受。轻便、好用、易扩展是他最重要的三个特点，其运行速度较同为 Electron 架构的Atom要快许多。微软也将代码开源放在GitHub上，一起来揭开vscode的神秘面纱吧。
- 此文开始于2019-07-30 晚上12:43:35，参考的Vscode源码版本为 1.19.3 VSCode v1.19.3，可直接下载ZIP压缩包，源码总大小11.7M。
- VSCode开源代码的Github地址为：
https://github.com/microsoft/vscode
项目阶段（持续更新）
- [ ] 第一阶段2019.07.28——介绍如何开发VSCode插件
- [ ] 第二阶段2019.08.09——详细分析VSCode开源代码 Part 1 代码结构
- [ ] 第三阶段2019.08.xx——详细分析VSCode开源代码 Part 2 源码编译运行
一、项目架构背景介绍
Electron
- Electron 是基于 Node.js 和 Chromium 的跨平台桌面应用开发框架。使用 JavaScipt，HTML，CSS 真正将 Node.js 带到了前端。Electron 通过 BrowserWindow 可以创建一个本地窗口，并加载一个HTML文档，BrowserWindow中的内容就是一个浏览器窗口，不仅能创建DOM元素，同时能使用任意的Node模块，并且还可以通过IPC与主进程通讯。
多进程
-
每一个 Electron 应用都对应一个主进程(main process)， 主进程通过BrowserWindow创建的每个本地窗口对应一个渲染进程(renderer process)。
vscode-process.png
主进程
- vscode的主进程主要负责创建窗口和菜单，生命周期管理，为进程通信基站（IPC Server），自动更新，工具条菜单栏注册等与系统相关的功能。
渲染进程
- 绝大多数代码都是运行在渲染进程中的，渲染进程负责界面的显示，响应用户操作。前面说到在浏览器中也可以使用Node模块，渲染进程还通过Node创建了一个插件子进程，负责插件的初始化。另外渲染进程还可以创建Worker执行一些复杂的计算，比如markdown的解析；需要跨renderer共享的用子进程拆出去，交由main管理。
插件进程
- 每一个渲染进程同时也对应一个插件进程，插件运行在单独的进程不会对渲染进程造成影响，这也是vscode比atom要快的原因。Atom中插件是直接运行在渲染进程中的，所以当插件很多的时候会卡。同时又由于vscode的插件运行在一个普通的Node进程中，所以对UI的操作能力是比较弱的，这点不及Atom。
二、源码分析基本结构
将GitHub托管的vscode源码clone下来，此处介绍的版本号为 1.19.3 VSCode v1.19.3。
目录结构
- 只展示主要的文件及目录
├── build # gulp编译构建脚本
├── extensions # 内置插件
├── resources # 平台相关静态资源，图标等
├── scripts # 工具脚本，开发/测试
├── src # 源码目录
├── test # 测试套件
├── out # 编译输出目录（执行编译后会有）
├── i18n # 国际化翻译包（最新版本已经移除，改用第三方插件形式下载使用）
├── package.json # 项目配置文件
├── product.json # App meta信息
└── gulpfile.js # gulp task
- src目录结果
├── bootstrap-amd.js # 子进程实际入口
├── bootstrap.js # 子进程环境初始化
├── buildfile.js # 构建config
├── cli.js # CLI入口
├── main.js # 主进程入口
├── paths.js # AppDataPath与DefaultUserDataPath
├── typings
│ └── xxx.d.ts # ts类型声明
└── vs
├── base # 通用工具/协议和UI库
│ ├── browser # 基础UI组件，DOM操作、交互事件、DnD等
│ ├── common # diff描述，markdown解析器，worker协议，各种工具函数
│ ├── node # Node工具函数
│ ├── parts # IPC协议（Electron、Node），quickopen、tree组件
│ ├── test # base单测用例
│ └── worker # Worker factory和main Worker（运行IDE Core：Monaco）
├── code # VS Code主窗体相关
├── editor # 对接IDE Core（读取编辑/交互状态），提供命令、上下文菜单、hover、snippet等支持
├── platform # 支持注入服务和平台相关基础服务（文件、剪切板、窗体、状态栏）
├── workbench # 协调editor并给viewlets提供框架，比如目录查看器、状态栏等，全局搜索，集成Git、Debug
├── buildunit.json
├── css.build.js # 用于插件构建的CSS loader
├── css.js # CSS loader
├── loader.js # AMD loader（用于异步加载AMD模块，类似于require.js）
├── nls.build.js # 用于插件构建的NLS loader
└── nls.js # NLS（National Language Support）多语言loader
与业务相关的关键部分
- src/vs/code：主窗体、工具栏菜单创建
- src/vs/editor：代码编辑器，IDE核心相关
- src/vs/workbench：UI布局，功能服务对接
src下的重要文件（夹）
base
base包封装了大量API，实现常用功能。在vscode中目录结构都是都是按照browser，common，node，electron的方式划分的。
- browser
browser中实现了一个简单的UI库，包括 Button，CheckBox，List，Scrollbar等常用组件。并且封装了一套类似JQuery的DOM操作API(参见 dom.ts 和 builder.ts)。
- common
common包中封装了大量实用工具类。如
- arrays.ts，strings.ts，objects.ts 封装了一套类似underscore的api。
- uri.ts 和 paths.ts 实现了路径解析功能。
- winjs.base.js 实现了一个功能强大的Promise。
- 另外还有很多其他的工具类，每一个模块的耦合度都很低，基本都可以单独拿出来用，学习起来也和容易。这里就不一一介绍了。
- node
node包中封装了一些node实现的功能。如
- extfs.ts 和 pfs.ts 封装了文件操作相关的api。
- request.ts 封装了网络请求的api，能方便的发送网络请求，加载json，下载文件。
- service.cp.ts 和 service.net.ts 封装了socket和进程通讯的api。
- zip.ts 封装了解压缩文件的操作
- parts
这个包额外定义了一些复杂的UI组件，tree 和 quickopen。
editor and language
本篇主要了解vscode基本框架的结构，这两包作为编辑器功能的主要实现，这里面的逻辑太复杂就不细说了。
platform and workbench
vscode中基本所有的具体功能实现代码都在这两包中。platform主要定义了一些服务的接口和简单实现，workbench则实现了这些接口，并且创建了一个工作台，构建了一个完整界面结构。
每层按目标执行环境细分组织结构（部分重要）：
- common：可跨环境复用的
- browser：依赖浏览器API的，比如DOM操作
- node：依赖Node API的
- electron-browser：依赖electron renderer-process API的
- electron-main：依赖electron main-process API的
★ IDE Core可独立使用，Monaco可以直接生成编辑器页面。Monaco的github仓库
下一节：第三阶段——详细分析VSCode开源代码 Part 2 源码编译运行
部分图片、文字摘取自：
- vscode源码剖析：总有人要做相同的事情
- VS Code源码简析：所幸巨人的肩膀正变得越来越高
