Windows环境编译Atom 1.59版本失败，求可用构建手册参考

前置依赖要求 #

必须严格匹配以下依赖版本，避免工具链不兼容问题：

• Node.js 14.17.x LTS版本（禁止使用15.x及以上版本，否则会出现v8头文件结构不兼容问题）
• Python 2.7.x版本（禁止使用Python 3.x版本，node-gyp编译原生模块仅适配Python 2.7）
• Visual Studio 2017 桌面开发C++组件，必须包含MSVC v141编译工具集
• 全局安装8.x版本的node-gyp，执行命令：npm install -g node-gyp@8

已知报错解决方案 #

1. cppgc/common.h不存在报错修复 #

该报错由Node.js版本过高导致，v8 9.x版本重构了头文件结构，Atom 1.59依赖的原生模块仅适配v8 8.x版本：

• 切换Node.js版本到14.17.x LTS，若使用nvm管理版本可执行命令：nvm use 14.17.0
• 清空本地node-gyp缓存，执行命令：rmdir /s /q %LOCALAPPDATA%\node-gyp\Cache
• 删除项目目录下script\node_modules\fs-admin文件夹，后续重新安装依赖时会自动拉取适配版本

2. about@1.9.1版本不存在报错修复 #

该报错由旧版本依赖包下架导致，可通过修改依赖声明解决：

• 打开项目根目录下的package.json文件，找到about依赖的版本声明，将版本号修改为1.9.2（该版本与Atom 1.59完全兼容）
• 删除项目根目录下的node_modules文件夹和package-lock.json文件

完整构建步骤 #

1. 完成前置依赖安装后，执行以下命令确认版本匹配：
   • node -v 输出应为v14.17.x
   • python -V 输出应为2.7.x
   • node-gyp -v 输出应为v8.x
2. 拉取Atom 1.59版本源码后，先按照上述报错解决方案修改package.json中的about依赖版本
3. 执行初始化脚本命令：script\bootstrap.cmd
4. 初始化完成后执行编译命令：script\build.cmd
5. 编译完成后可执行测试命令验证构建结果：script\test.cmd

内容的提问来源于stack exchange，提问作者Milton