自行编译开源版VS Code

微软提供的Visual Studio Code代码编辑器软件易于使用,广为普及。然而,尽管该软件早已开源在GitHub(以MIT许可证授权)。但是,在微软官网上下载的微软编译版本,则默认以Microsoft软件许可条款提供,这对更倾向使用自由软件的“强迫症患者”并不友好。本文介绍如何自行在家用Windows电脑上编译开源版本的VS Code。

环境准备

  1. 硬件方面,你的电脑需要至少4GB的RAM,并需要至少1GiB的存储空间来存放编译用的代码、生成的程序等。
  2. 前往Node.js官网,下载LTS版本的Node.js。根据文档,编译VS Code的环境需要大于等于10.x版本、小于等于12.x版本的Node.js运行环境。
    输入npm -g install yarn命令,安装yarn。
  3. 以管理员身份打开Windows命令行,输入npm install --g windows-build-tools --vs2015命令,安装Windows Build Tools;其中的--vs2015表示安装Visual Studio 2015附带的编译工具。
  4. 从GitHub下载最新的正式版本。截至本文撰写,最新的版本为2020年8月的第二修复版(V1.49.2)。不建议直接克隆代码库,因为版本数量太过庞大。此外,应该注意到,将代码解压后,所在路径应全部为ASCII字符,否则编译时会引发node-gyp的报错。

编译

  1. 安装依赖:yarn
  2. 检查依赖及清理编译环境:yarn watch
  3. 编译为可执行文件:yarn run gulp vscode-win32-ia32
  4. 到上级目录找到VSCode-win32-ia32文件夹,运行Code - OSS.exe

常见问题

一、计算机性能问题

根据编译时的报错提示,电脑最低需要有4GiB的物理内存才能编译该程序。这个报错来自于VSCode代码中写入的限制,且可以通过修改代码规避。但根据实际编译的情况,不建议把这个限制去掉。

二、网络问题

由于众所周知的原因,在国内直接下载registry.yarnpkg.com及GitHub上的安装包有一定的困难,故建议将yarn的源更换为淘宝等国内镜像,如果一时无法下载,也可多试几次。