微软提供的Visual Studio Code代码编辑器软件易于使用,广为普及。然而,尽管该软件早已开源在GitHub(以MIT许可证授权)。但是,在微软官网上下载的微软编译版本,则默认以Microsoft软件许可条款提供,这对更倾向使用自由软件的“强迫症患者”并不友好。本文介绍如何自行在家用Windows电脑上编译开源版本的VS Code。
环境准备
- 硬件方面,你的电脑需要至少4GB的RAM,并需要至少1GiB的存储空间来存放编译用的代码、生成的程序等。
- 前往Node.js官网,下载LTS版本的Node.js。根据文档,编译VS Code的环境需要大于等于10.x版本、小于等于12.x版本的Node.js运行环境。
输入npm -g install yarn
命令,安装yarn。 - 以管理员身份打开Windows命令行,输入
npm install --g windows-build-tools --vs2015
命令,安装Windows Build Tools;其中的--vs2015
表示安装Visual Studio 2015附带的编译工具。 - 从GitHub下载最新的正式版本。截至本文撰写,最新的版本为2020年8月的第二修复版(V1.49.2)。不建议直接克隆代码库,因为版本数量太过庞大。此外,应该注意到,将代码解压后,所在路径应全部为ASCII字符,否则编译时会引发node-gyp的报错。
编译
- 安装依赖:
yarn
- 检查依赖及清理编译环境:
yarn watch
- 编译为可执行文件:
yarn run gulp vscode-win32-ia32
- 到上级目录找到
VSCode-win32-ia32
文件夹,运行Code - OSS.exe
常见问题
一、计算机性能问题
根据编译时的报错提示,电脑最低需要有4GiB的物理内存才能编译该程序。这个报错来自于VSCode代码中写入的限制,且可以通过修改代码规避。但根据实际编译的情况,不建议把这个限制去掉。
二、网络问题
由于众所周知的原因,在国内直接下载registry.yarnpkg.com及GitHub上的安装包有一定的困难,故建议将yarn的源更换为淘宝等国内镜像,如果一时无法下载,也可多试几次。