VSCode 是微软旗下使用量很高的软件，并支持几乎所有桌面平台。所以首先， 需要自行安装 VSCode。 目前 EGE 插件主要支持了 Windows、Mac 和 Debian(Ubuntu) 平台。

其他类似图文教程可参考: 依稀’s EGE 安装与配置教程 里面的 VisualStudioCode 相关章节。

安装 EGE 插件

EGE 为 VSCode 提供了官方插件，安装完成 VSCode 之后，可以直接去 VSCode 的插件市场搜索 EGE，找到我们的插件安装即可快速使用EGE。 得益于 VSCode 的默认更新机制， EGE VSCode 插件会自动更新内置的 EGE， 保持最新版本。

搜索并安装 EGE 插件完成后，即可使用 EGE 相关指令。

安装 EGE 插件依赖环境

EGE 默认使用 CMake 来构建项目， 所以， 推荐大家都安装 CMake：https://cmake.org/download/

对于不同的操作系统以及编译器， 需要解决如下依赖:

• Windows: EGE 插件在 Windows 上主要依赖 Visual Studio 或 MINGW (注意是”或”，任选其一)。请搜索并安装其中至少一项。
  • Visual Studio: https://visualstudio.microsoft.com/zh-hans/
• Mac: EGE 插件在 Mac 上编译需要 mingw-w64 来编译代码， 以及 wine-stable 来执行 exe 文件
  • Mac上通过 brew 安装: brew install mingw-w64 wine-stable
  • 如果网络不好, 无法安装, 可加入 EGE 官网首页社区咨询。
• Linux (Debian/Ubuntu): EGE 插件在 Linux上编译也需要 mingw-w64 和 wine64。
  • 可以通过 apt 直接安装: apt install mingw-w64 wine64
• 其他 Linux 系统 由于 EGE 插件尚未提供对应的 二进制库， 所以插件暂未支持。后续将提供直接链接源码的方式以支持所有系统。

使用 EGE VSCode插件

可以使用快捷键 Ctrl+Shift+P (Windows/Linux) 或者 ⌘+Shift+P (Mac) 呼出 VSCode 的菜单，然后输入 “EGE” 过滤并查看 EGE 相关菜单。

Windows 下使用 EGE 编译单个文件 (仅支持 Visual Studio 编译器）

在 Windows 下， 打开一个 cpp 文件, 并执行 EGE 插件的 “Build and run current file” 指令即可:

使用 EGE 插件将代码配置成 CMake 项目并编译运行 (支持 Windows、Mac、Linux)

使用 Visual Studio 打开一个空目录， 并执行 EGE 插件的 “Setup with this project” 指令即可创建模板 CMake 项目:

创建完了 CMake 项目之后， 刷新一下 VSCode (或者重新启动 VSCode) 即可使用模板项目里面默认的 VSCode 编译指令

生成模板项目之后， 需要这样刷新一下 VSCode 才能看见编译指令↑

使用 VSCode 编译 CMake 项目

上一步创建项目成功后， 能看到项目根目录生成了 CMakeLists.txt 等文件. 刷新 VSCode 之后， 即可使用编译指令。

可以使用快捷键 Ctrl+Shift+B (Windows/Linux) 或者 ⌘+Shift+B (Mac) 来呼出 VSCode 的项目编译指令:

按下快捷键之后，将看到如上图的菜单界面，可以使用 “Load And Build Project” 指令来一步完成项目加载和构建， 然后使用 “Run Project” 指令来运行模板项目生成的可执行文件。

这里呼出的指令是预设在项目的 “.vscode/tasks.json” 里面的。感兴趣的初学者可以查看并修改或添加自己想要的指令，方便自己的项目。

下方是对于模板项目的执行结果截图:

VSCode 里面调试项目代码 (Windows)

当模板配置好了之后， 你也可以使用 VSCode 默认的快捷键 “F5” 来启动程序调试。

首先， 你可以在项目中的 cpp 文件中， 添加断点， 只需要在文件左侧行号左侧鼠标点击， 或者光标定位到指定的行之后按下键盘上的 “F9” 即可：

之后使用”F5″启动调试:

为了便于演示， 稍微修改了一下演示代码, 增加了两个局部变量以演示。 直接使用 VSCode 打开模板项目， 按下 “F5” 即可启动调试并看到效果。

注意， EGE 插件内置的模板项目的调试功能， 仅在 Windows 项目下有效， 在 Mac 以及 Linux 上目前暂时无法调试。

在非 Windows 平台下运行的注意事项

首先， 需要安装 mingw-w64 作为编译器， 以及 wine 来执行程序。 这里前文已经有所描述， 忘记的同学请继续翻阅本文开头。

在 Mac 下安装 wine-stable 并运行 EGE 程序的注意事项

Mac 下使用 brew 安装 “wine-stable” 之后， 首次启动可能会遇到权限问题， 需要进行一些配置，这里尝试给出一个较为简单的解决办法， 当 Mac 下使用 brew 安装完 “wine-stable” 之后， 可以在应用程序里面找到 wine 的对应的 app，位置大致在 “/Applications/Wine Stable.app”，我们在 Finder 中找到它并右键点击“打开”:

之后在系统设置的“隐私与安全”这个选项的最末位， 找到安全选项里面的允许 wine

之后再在 Mac 的 VSCode 里面执行模板项目的 “Run Project” 指令， 即可运行模板项目编译生成的可执行文件了。

完成，结束

至此，你的第一个 EGE 项目就创建并运行成功啦！这是一个 CMake 的项目，可以支持 Windows、Mac、Linux(Debian/Ubuntu) 等。

如果你仍有未解决的问题， 请在本文下方留言并讨论。