5分钟从源码运行 VS Code

本指南将帮助你在5分钟内从源码构建并运行 VS Code 编辑器

环境要求

支持的操作系统

Windows macOS Linux

运行环境

Node.js >= 18.0.0 必需
Python >= 3.7.0 必需

所需工具

Git

克隆源代码仓库

必需

操作步骤

1

克隆仓库

克隆 VS Code 源代码仓库到本地

克隆主仓库
git clone https://github.com/microsoft/vscode.git

预期结果:克隆完成后会创建 vscode 目录

如果网络较慢,可以使用 GitHub 镜像源

2

进入项目目录

切换到项目目录并安装依赖

进入项目根目录
cd vscode
安装所有依赖包
npm install

预期结果:看到大量依赖包被下载和安装

首次安装可能需要5-10分钟,取决于网络速度

3

编译并运行

编译项目并启动 VS Code 编辑器

启动编译监视模式(新开终端)
npm run watch
在另一个终端中启动 VS Code
npm run electron

预期结果:VS Code 编辑器窗口成功打开

需要打开两个终端窗口,一个用于编译监视,一个用于运行

验证成功

成功启动 VS Code 编辑器窗口

看到 VS Code 启动画面
编辑器主界面正常显示
可以创建和编辑文件

快速提示

配置

如果 npm install 失败,尝试使用 npm install --legacy-peer-deps

性能

开发模式下运行速度较慢是正常的,正式构建会优化性能

调试

使用 Ctrl+Shift+P 打开命令面板测试功能

常见问题

1

npm install 失败,提示权限错误

使用管理员权限运行,或修复 npm 权限:npm config set unsafe-perm true

2

编译时报错缺少依赖

确保已安装 Python 3.7+ 并添加到 PATH,Windows 用户需要安装 Windows Build Tools

3

运行 npm run electron 时报错

确保 npm run watch 正在运行并已完成初始编译

下一步

查看官方贡献指南

了解如何参与 VS Code 开发

尝试修改代码并重新编译

体验开发流程

探索扩展开发

学习如何为 VS Code 开发扩展

助手