hexo-theme-volantis/scripts/events/lib/check-environment.js

Elegant and powerful theme for Hexo.

// 环境配置检查可以避免一些奇葩的报错

const exec = require('child_process').exec;

function getVersionNumber(str, regex) {
  const match = str.match(regex);
  return match ? match[1] : null;
}

module.exports =(hexo) => {
  if (!hexo.checkEnvironment) {
    hexo.checkEnvironment = 1;
    hexo.log.info(`Checking environment configuration...`);

    // Checking environment
    exec('node -v', (err, stdout, stderr) => {
      if (err) {
        CheckError(hexo, `node.js: ${err}`);
      }
      const nodeVersion = getVersionNumber(stdout, /v(\d*)/);
      if (nodeVersion < 16) {
        hexo.log.info(`node.js 版本：${stdout}`);
        CheckError(hexo, `node.js 版本过低，请升级至 v16.x 及以上版本！`);
      } else {
        exec('hexo -v', (err, stdout, stderr) => {
          if (err) {
            CheckError(hexo, `hexo-cli: ${err}`);
          }
          const hexoVersion1 = getVersionNumber(stdout, /hexo:\s*(\d*)/);
          const hexoVersion2 = getVersionNumber(stdout, /hexo:\s*\d*\.(\d*)/);
          if (hexoVersion1 < 5 || (hexoVersion1 === 5 && hexoVersion2 < 4)) {
            hexo.log.info(`hexo  版本：${stdout}`);
            CheckError(hexo, `hexo 版本过低，请升级至 5.4 以上版本！`);
          } else {
            const hexoClVersion1 = getVersionNumber(stdout, /hexo-cli:\s*(\d*)/);
            const hexoClVersion2 = getVersionNumber(stdout, /hexo-cli:\s*\d*\.(\d*)/);
            if (hexoClVersion1 < 4 || (hexoClVersion1 === 4 && hexoClVersion2 < 1)) {
              hexo.log.info(`hexo-cli 版本：${stdout}`);
              CheckError(hexo, `hexo-cli 版本过低，请升级至 4.1 以上版本！`);
            } else {
              // Checking configuration
              let checkConfiguration = require('./check-configuration')(hexo);
              if (checkConfiguration !== true) {
                CheckConfError(hexo, checkConfiguration);
              }
            }
          }
        });
      }
    });
  }
};

function CheckError(hexo, msg) {
  hexo.log.error(`
============================================================
环境配置检查失败！| Environment configuration check failed!
============================================================
${msg}
============================================================
推荐的配置：
Hexo: 7.3 ~ latest
hexo-cli: 4.3 ~ latest
node.js: 22.x LTS ~ latest LTS
npm: 10.x ~ latest LTS
============================================================
# 当前 Debug 调试模式
debug: env
关闭调试模式主题配置文件设置 debug: false
============================================================`);
  throw new Error('环境配置检查失败！| Environment configuration check failed!');
}

function CheckConfError(hexo, msg) {
  hexo.log.error(`
============================================================
配置文件检查失败！| Configuration check failed!
============================================================
${msg}
============================================================
# 当前 Debug 调试模式
debug: env
关闭调试模式主题配置文件设置 debug: false
============================================================`);
  throw new Error('配置文件检查失败！| Configuration check failed!');
}