@flun/nodejs-mobile-gyp 1.2.0 → 1.2.2

package/lib/build.js

@@ -7,8 +7,7 @@ import os from 'os';
 import { spawnSync } from 'child_process';
 import fsSync from 'fs';
 
-const fs = gracefulFs.promises,
-  _hostIsWindows = process.platform === 'win32',
+const fs = gracefulFs.promises, _hostIsWindows = process.platform === 'win32',
   // Android 交叉编译即使宿主是 Windows,也必须走 make(make-android 生成器)
   _isAndroidCrossBuild = process.env.npm_config_platform === 'android' || process.env.npm_config_format === 'make-android',
   // win 在此文件中语义为"使用 MSBuild":仅 Windows 宿主且非 Android 交叉编译
@@ -20,12 +19,11 @@ const fs = gracefulFs.promises,
    */
   findWindowsShellDir = () => {
     if (process.platform !== 'win32') return null;
-    const tryShDir = (dir) => {
+    const tryShDir = dir => {
       try { return fsSync.existsSync(path.join(dir, 'sh.exe')) ? dir : null } catch { return null }
-    };
-    const toShDir = (gitRoot) => tryShDir(path.join(gitRoot, 'usr', 'bin'));
-    // 1) 注册表:Git for Windows 安装时必写,与 PATH 无关(最可靠)
-    const reg = process.env.SystemRoot ? path.join(process.env.SystemRoot, 'System32', 'reg.exe') : 'reg.exe';
+    }, toShDir = (gitRoot) => tryShDir(path.join(gitRoot, 'usr', 'bin')),
+      // 1) 注册表:Git for Windows 安装时必写,与 PATH 无关(最可靠)
+      reg = process.env.SystemRoot ? path.join(process.env.SystemRoot, 'System32', 'reg.exe') : 'reg.exe';
     for (const hive of ['HKLM', 'HKCU']) {
       for (const key of ['SOFTWARE\\GitForWindows', 'SOFTWARE\\WOW6432Node\\GitForWindows']) {
         try {
@@ -44,8 +42,7 @@ const fs = gracefulFs.promises,
     try {
       const gitPath = which.sync('git');
       if (gitPath) {
-        const dir = path.resolve(path.dirname(gitPath), '..', 'usr', 'bin');
-        const r = tryShDir(dir);
+        const dir = path.resolve(path.dirname(gitPath), '..', 'usr', 'bin'), r = tryShDir(dir);
         if (r) return r;
       }
     } catch { }
@@ -54,16 +51,13 @@ const fs = gracefulFs.promises,
       if (!pd) continue;
       try {
         if (fsSync.existsSync(path.join(pd, 'git.exe'))) {
-          const dir = path.resolve(pd, '..', 'usr', 'bin');
-          const r = tryShDir(dir);
+          const dir = path.resolve(pd, '..', 'usr', 'bin'), r = tryShDir(dir);
           if (r) return r;
         }
       } catch { }
     }
     // 4) 全盘符常见位置兜底
-    const suffixes = [
-      'Program Files\\Git', 'Program Files (x86)\\Git', 'Git', 'msys64',
-    ];
+    const suffixes = ['Program Files\\Git', 'Program Files (x86)\\Git', 'Git', 'msys64'];
     for (const drv of ['C:', 'D:', 'E:', 'F:']) {
       for (const sfx of suffixes) {
         const dir = tryShDir(drv + '\\' + sfx);
@@ -104,7 +98,7 @@ const fs = gracefulFs.promises,
         // 注意:msbuild 的 Condition 字符串相等比较不区分大小写
         const archLower = arch.toLowerCase(), p = archLower === 'x64' ? 'x64' : (archLower === 'arm' ? 'ARM'
           : (archLower === 'arm64' ? 'ARM64' : 'Win32'));
-        argv.push('/p:Configuration=' + buildType + ';Platform=' + p)
+        argv.push('/p:Configuration=' + buildType + ';Platform=' + p);
         if (jobs) {
           j = parseInt(jobs, 10)
           if (!isNaN(j) && j > 0) argv.push('/m:' + j);
@@ -134,21 +128,18 @@ const fs = gracefulFs.promises,
           const shellDir = findWindowsShellDir();
           if (shellDir) {
             process.env.PATH = `${shellDir};${process.env.PATH}`;
-            log.verbose('bin shell', `prepended ${shellDir} to PATH for make`);
-          } else {
-            log.warn('bin shell', 'no sh.exe found; GNU make 的 Unix 命令可能失败;建议安装 Git for Windows');
+            log.verbose('bin 环境', `已将 ${shellDir} 加入 PATH,供 make 使用`);
           }
+          else log.warn('shell 环境', '未找到 sh.exe;GNU make 的 Unix 命令可能失败;建议安装 Git for Windows');
         }
-        process.env.PATH = _hostIsWindows
-          ? `${buildBinsDir};${process.env.PATH}`
-          : `${buildBinsDir}:${process.env.PATH}`;
+        process.env.PATH = _hostIsWindows ? `${buildBinsDir};${process.env.PATH}` : `${buildBinsDir}:${process.env.PATH}`;
         await fs.mkdir(buildBinsDir, { recursive: true });
 
         if (_hostIsWindows) {
           // Windows 无 python3 名称,且创建符号链接需要管理员权限;改用 .cmd 桥接
           const shimPath = path.join(buildBinsDir, 'python3.cmd');
           await fs.writeFile(shimPath, `@echo off\r\n"${python}" %*\r\n`);
-          log.verbose('bin shims', `created python3.cmd shim to "${python}" and added to PATH`);
+          log.verbose('bin 垫片', `已创建 python3.cmd 指向 "${python}" 并加入 PATH`);
         } else {
           const symlinkDestination = path.join(buildBinsDir, 'python3');
           try {
@@ -157,16 +148,15 @@ const fs = gracefulFs.promises,
             if (err.code !== 'ENOENT') throw err;
           }
           await fs.symlink(python, symlinkDestination);
-          log.verbose('bin symlinks', `created symlink to "${python}" in "${buildBinsDir}" and added to PATH`);
+          log.verbose('bin 符号链接', `已在 "${buildBinsDir}" 创建指向 "${python}" 的符号链接并加入 PATH`);
         }
       }
 
       const proc = gyp.spawn(command, argv);
       await new Promise((resolve, reject) => proc.on('exit', async (code, signal) => {
         if (buildBinsDir) await fs.rm(buildBinsDir, { recursive: true }); // 清理构建期依赖的符号链接
-
-        if (code !== 0) return reject(new Error('`' + command + '` failed with exit code: ' + code));
-        if (signal) return reject(new Error('`' + command + '` got signal: ' + signal));
+        if (code !== 0) return reject(new Error('`' + command + '` 执行失败,退出码: ' + code));
+        if (signal) return reject(new Error('`' + command + '` 收到信号: ' + signal));
         resolve();
       }))
     },
@@ -174,16 +164,16 @@ const fs = gracefulFs.promises,
        * 用 node-which 定位 msbuild / make 可执行文件
        */
       doWhich = async () => {
-        // Windows 使用 node-gyp configure 提供的 msbuild
+        // Windows 使用 nodejs-mobile-gyp configure 提供的 msbuild
         if (win) {
-          if (!config.variables.msbuild_path) throw new Error('MSBuild 未设置,请先运行 `node-gyp configure`');
-          command = config.variables.msbuild_path, log.verbose('using MSBuild:', command), await doBuild();
+          if (!config.variables.msbuild_path) throw new Error('MSBuild 未设置,请先运行 `nodejs-mobile-gyp configure`');
+          command = config.variables.msbuild_path, log.verbose('使用 MSBuild:', command), await doBuild();
           return;
         }
 
         // 先确认构建命令在 PATH 中
         const execPath = await which(command);
-        log.verbose('`which` succeeded for `' + command + '`', execPath), await doBuild();
+        log.verbose('`which` 成功解析 `' + command + '`', execPath), await doBuild();
       },
       /**
        * Windows 下查找第一个 build/*.sln 文件
@@ -191,7 +181,7 @@ const fs = gracefulFs.promises,
       findSolutionFile = async () => {
         const files = await glob('build/*.sln')
         if (files.length === 0) throw new Error('未找到 *.sln 文件,是否运行过 configure?');
-        guessedSolution = files[0], log.verbose('found first Solution file', guessedSolution), await doWhich();
+        guessedSolution = files[0], log.verbose('找到首个解决方案文件', guessedSolution), await doWhich();
       },
       /**
        * 加载 configure 阶段生成的 config.gypi
@@ -202,7 +192,7 @@ const fs = gracefulFs.promises,
           const configPath = path.resolve('build', 'config.gypi');
           data = await fs.readFile(configPath, 'utf8');
         } catch (err) {
-          if (err.code === 'ENOENT') throw new Error('请先运行 `node-gyp configure`');
+          if (err.code === 'ENOENT') throw new Error('请先运行 `nodejs-mobile-gyp configure`');
           else throw err;
         }
 
@@ -213,13 +203,13 @@ const fs = gracefulFs.promises,
         if ('debug' in gyp.opts) buildType = gyp.opts.debug ? 'Debug' : 'Release';
         if (!buildType) buildType = 'Release';
 
-        log.verbose('build type', buildType), log.verbose('architecture', arch), log.verbose('node dev dir', nodeDir);
-        log.verbose('python', python);
+        log.verbose('构建类型', buildType), log.verbose('架构', arch), log.verbose('node 开发目录', nodeDir);
+        log.verbose('Python', python);
 
         win ? await findSolutionFile() : await doWhich();
       };
     await loadConfigGypi();
   };
 
-build.usage = 'Invokes `' + (win ? 'msbuild' : 'make') + '` and builds the module';
+build.usage = '调用 `' + (win ? 'msbuild' : 'make') + '` 构建模块';
 export { build };

package/lib/clean.js

@@ -8,9 +8,9 @@ const fs = gracefulFs.promises,
   clean = async (gyp, argv) => {
     const buildDir = 'build';
 
-    log.verbose('clean', 'removing "%s" directory', buildDir);
+    log.verbose('清理', '正在删除 "%s" 目录', buildDir);
     await fs.rm(buildDir, { recursive: true, force: true });
   }
 
-clean.usage = 'Removes any generated build files and the "out" dir';
+clean.usage = '删除生成的构建文件与 "out" 目录';
 export { clean };

package/lib/configure.js

@@ -30,11 +30,11 @@ const configure = async (gyp, argv) => {
     runGyp = async () => {
       if (!~argv.indexOf('-f') && !~argv.indexOf('--format')) {
         if (win) {
-          log.verbose('gyp', 'gyp format was not specified; forcing "msvs"');
+          log.verbose('gyp', '未指定 gyp 格式,强制使用 "msvs"');
           // 非 Windows 强制使用 make 目标
           argv.push('-f', ('format' in gyp.opts) ? gyp.opts.format : 'msvs');
         } else {
-          log.verbose('gyp', 'gyp format was not specified; forcing "make"');
+          log.verbose('gyp', '未指定 gyp 格式,强制使用 "make"');
           // 非 Windows 强制使用 make 目标
           argv.push('-f', ('format' in gyp.opts) ? gyp.opts.format : 'make');
         }
@@ -42,7 +42,7 @@ const configure = async (gyp, argv) => {
 
       configs.forEach(config => argv.push('-I', config)); // 引入所有找到的 .gypi 文件
       // AIX 和 z/OS 需要设置导出文件路径,其中包含链接所需符号
-      let nodeExpFile, nodeRootDir, candidates, logprefix = 'find exports file';
+      let nodeExpFile, nodeRootDir, candidates, logprefix = '查找导出文件';
       if (process.platform === 'aix' || process.platform === 'os390' || process.platform === 'os400') {
         const ext = process.platform === 'os390' ? 'x' : 'exp';
         nodeRootDir = findNodeDirectory();
@@ -55,10 +55,10 @@ const configure = async (gyp, argv) => {
             'out/Debug/obj.target/libnode', 'lib/libnode'].map(file => file + '.' + ext);
 
         nodeExpFile = findAccessibleSync(logprefix, nodeRootDir, candidates);
-        if (nodeExpFile !== undefined) log.verbose(logprefix, 'Found exports file: %s', nodeExpFile);
+        if (nodeExpFile !== undefined) log.verbose(logprefix, '已找到导出文件: %s', nodeExpFile);
         else {
-          const msg = msgFormat('Could not find node.%s file in %s', ext, nodeRootDir);
-          log.error(logprefix, 'Could not find exports file');
+          const msg = msgFormat('未找到 node.%s 文件,目录: %s', ext, nodeRootDir);
+          log.error(logprefix, '未找到导出文件');
           throw new Error(msg);
         }
       }
@@ -66,14 +66,14 @@ const configure = async (gyp, argv) => {
       // z/OS 需要设置 zoslib 头文件目录,其中包含 v8config.h 引用的头文件
       let zoslibIncDir;
       if (process.platform === 'os390') {
-        logprefix = "find zoslib's zos-base.h:";
+        logprefix = "查找 zoslib 的 zos-base.h:";
         let msg, zoslibIncPath = process.env.ZOSLIB_INCLUDES;
         if (zoslibIncPath) {
           zoslibIncPath = findAccessibleSync(logprefix, zoslibIncPath, ['zos-base.h']);
           if (zoslibIncPath === undefined) {
-            msg = msgFormat('Could not find zos-base.h file in the directory set ' +
-              'in ZOSLIB_INCLUDES environment variable: %s; set it ' +
-              'to the correct path, or unset it to search %s', process.env.ZOSLIB_INCLUDES, nodeRootDir)
+            msg = msgFormat('在 ZOSLIB_INCLUDES 指定的目录中未找到 zos-base.h 文件: ' +
+              '%s; 请将其设为正确路径,或取消设置以便在 ' +
+              '%s 中搜索', process.env.ZOSLIB_INCLUDES, nodeRootDir)
           }
         } else {
           candidates = [
@@ -82,14 +82,14 @@ const configure = async (gyp, argv) => {
           ]
           zoslibIncPath = findAccessibleSync(logprefix, nodeRootDir, candidates);
           if (zoslibIncPath === undefined) {
-            msg = msgFormat('Could not find any of %s in directory %s; set ' +
-              'environmant variable ZOSLIB_INCLUDES to the path ' +
-              'that contains zos-base.h', candidates.toString(), nodeRootDir)
+            msg = msgFormat('未找到 %s 中列出的任意一项(目录: %s); ' +
+              '请设置环境变量 ZOSLIB_INCLUDES 指向包含 zos-base.h 的路径',
+              candidates.toString(), nodeRootDir);
           }
         }
         if (zoslibIncPath !== undefined) {
           zoslibIncDir = path.dirname(zoslibIncPath);
-          log.verbose(logprefix, "Found zoslib's zos-base.h in: %s", zoslibIncDir);
+          log.verbose(logprefix, "在 %s 中找到 zoslib 的 zos-base.h", zoslibIncDir);
         } else if (release.version.split('.')[0] >= 16) {
           // zoslib 只随 Node v16 及以上发布
           log.error(logprefix, msg);
@@ -148,7 +148,7 @@ const configure = async (gyp, argv) => {
       await new Promise((resolve, reject) => {
         const cp = gyp.spawn(python, argv);
         cp.on('exit', code => {
-          if (code !== 0) reject(new Error('`gyp` failed with exit code: ' + code));
+          if (code !== 0) reject(new Error('`gyp` 执行失败,退出码: ' + code));
           else resolve(); // 完成
         })
       })
@@ -158,9 +158,9 @@ const configure = async (gyp, argv) => {
       if (!name) return runGyp();
 
       const fullPath = path.resolve(name);
-      log.verbose(name, 'checking for gypi file: %s', fullPath);
+      log.verbose(name, '正在检查 gypi 文件: %s', fullPath);
       try {
-        await fs.stat(fullPath), log.verbose(name, 'found gypi file'), configs.push(fullPath);
+        await fs.stat(fullPath), log.verbose(name, '已找到 gypi 文件'), configs.push(fullPath);
       } catch (err) {
         if (err.code !== 'ENOENT') throw err; // ENOENT 时继续检查下一个 gypi 文件名
       }
@@ -177,10 +177,10 @@ const configure = async (gyp, argv) => {
       return findConfigs();
     },
     createBuildDir = async () => {
-      log.verbose('build dir', 'attempting to create "build" dir: %s', buildDir);
+      log.verbose('build 目录', '正在创建 "build" 目录: %s', buildDir);
 
       const isNew = await fs.mkdir(buildDir, { recursive: true });
-      log.verbose('build dir', '"build" dir needed to be created?', isNew ? 'Yes' : 'No');
+      log.verbose('build 目录', '"build" 目录是否需要创建?', isNew ? '是' : '否');
       vsInfo = win ? await findVisualStudio(release.semver, gyp.opts['msvs-version']) : null;
       return createConfigFile();
     },
@@ -191,23 +191,23 @@ const configure = async (gyp, argv) => {
       if (gyp.opts.nodedir) {
         // 指定了 --nodedir,用它作为开发文件目录
         nodeDir = gyp.opts.nodedir.replace(/^~/, os.homedir());
-        log.verbose('get node dir', 'compiling against specified --nodedir dev files: %s', nodeDir);
+        log.verbose('获取 node 目录', '使用指定的 --nodedir 开发文件编译: %s', nodeDir);
       } else {
         // 未指定 --nodedir,先确保 Node 依赖已安装
         if ('v' + release.version !== process.version) {
           // 指定了 --target,确定目标版本
-          log.verbose('get node dir', 'compiling against --target node version: %s', release.version);
+          log.verbose('获取 node 目录', '按 --target 指定的 node 版本编译: %s', release.version);
         } else {
           // 未指定 --target,使用当前主机 Node 版本
-          log.verbose('get node dir',
-              'no --target version specified, falling back to host node version: %s', release.version);
+          log.verbose('获取 node 目录',
+              '未指定 --target 版本,回退到宿主 node 版本: %s', release.version);
         }
 
         if (!release.semver) throw new Error('版本号无效: ' + release.version); // 无法用 semver 解析版本字符串
         // 如果指定了 tarball 选项,总是删除并重装 headers 到 devdir,
         // 否则只在不存在时安装
         gyp.opts.ensure = !gyp.opts.tarball, await gyp.commands.install([release.version]);
-        log.verbose('get node dir', 'target node version installed:', release.versionDir);
+        log.verbose('获取 node 目录', '目标 node 版本已安装:', release.versionDir);
         nodeDir = path.resolve(gyp.devDir, release.versionDir);
       }
 
@@ -216,5 +216,5 @@ const configure = async (gyp, argv) => {
   return getNodeDir();
 };
 
-configure.usage = 'Generates ' + (win ? 'MSVC project files' : 'a Makefile') + ' for the current module';
+configure.usage = '为当前模块生成 ' + (win ? 'MSVC 项目文件' : 'Makefile') + ';';
 export { configure };

package/lib/create-config-gypi.js

@@ -25,7 +25,7 @@ const fs = gracefulFs.promises,
       try {
         const baseConfigGypi = await fs.readFile(path.resolve(nodeDir, 'include/node/config.gypi'));
         return parseConfigGypi(baseConfigGypi.toString());
-      } catch (err) { log.warn('read config.gypi', err.message) }
+      } catch (err) { log.warn('读取 config.gypi', err.message) }
     }
 
     return JSON.parse(JSON.stringify(process.config)); // 回退到 process.config
@@ -89,7 +89,7 @@ const fs = gracefulFs.promises,
   createConfigGypi = async ({ gyp, buildDir, nodeDir, vsInfo, python }) => {
     const configFilename = 'config.gypi', configPath = path.resolve(buildDir, configFilename);
 
-    log.verbose('build/' + configFilename, 'creating config file');
+    log.verbose('build/' + configFilename, '正在创建配置文件');
     const config = await getCurrentConfigGypi({ gyp, nodeDir, vsInfo, python }),
       // 保证 config.gypi 中的布尔值都转成字符串
       boolsToString = (k, v) => {
@@ -101,7 +101,7 @@ const fs = gracefulFs.promises,
     // 把 config.gypi 写入 build/ 目录
     const prefix = '# Do not edit. File was generated by node-gyp\'s "configure" step',
       json = JSON.stringify(config, boolsToString, 2);
-    log.verbose('build/' + configFilename, 'writing out config file: %s', configPath);
+    log.verbose('build/' + configFilename, '正在写出配置文件: %s', configPath);
     await fs.writeFile(configPath, [prefix, json, ''].join('\n'));
     return configPath;
   };

package/lib/find-node-directory.js

@@ -13,20 +13,20 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url)),
 
     // 看看上层目录结构,判断当前所处位置
     const npmParentDirectory = path.join(scriptLocation, '../../../..');
-    log.verbose('node-gyp root', 'npm_parent_directory is ' + path.basename(npmParentDirectory));
-    log.verbose('node-gyp root', 'Finding node root directory');
+    log.verbose('nodejs-mobile-gyp 根目录', 'npm 上级目录为 ' + path.basename(npmParentDirectory));
+    log.verbose('nodejs-mobile-gyp 根目录', '正在查找 node 根目录');
     let nodeRootDir = '';
     if (path.basename(npmParentDirectory) === 'deps') {
       // 处于构建目录中,脚本位于 deps/npm/node_modules/node-gyp/lib
       nodeRootDir = path.join(npmParentDirectory, '..');
-      log.verbose('node-gyp root', 'in build directory, root = ' + nodeRootDir);
+      log.verbose('nodejs-mobile-gyp 根目录', '在构建目录中,根目录 = ' + nodeRootDir);
     } else if (path.basename(npmParentDirectory) === 'node_modules') {
       // 处于 Node 安装目录中,脚本位于
       // lib/node_modules/npm/node_modules/node-gyp/lib 或
       // node_modules/npm/node_modules/node-gyp/lib(视平台而定)
       if (processObj.platform === 'win32') nodeRootDir = path.join(npmParentDirectory, '..');
       else nodeRootDir = path.join(npmParentDirectory, '../..');
-      log.verbose('node-gyp root', 'in install directory, root = ' + nodeRootDir);
+      log.verbose('nodejs-mobile-gyp 根目录', '在安装目录中,根目录 = ' + nodeRootDir);
     } else {
       // 无法判断,尝试从 node 可执行文件的位置推断
       const nodeDir = path.dirname(processObj.execPath), directoryUp = path.basename(nodeDir);

package/lib/find-python.js

@@ -51,7 +51,7 @@ const win = process.platform === 'win32',
 class PythonFinder {
   static findPython = (...args) => new PythonFinder(...args).findPython();
 
-  log = log.withPrefix('find Python');
+  log = log.withPrefix('查找 Python');
   argsExecutable = ['-c', 'import sys; print(sys.executable);'];
   argsVersion = ['-c', 'import sys; print("%s.%s.%s" % sys.version_info[:3]);'];
   semverRange = '>=3.6.0';
@@ -78,8 +78,8 @@ class PythonFinder {
         if (this.env.NODE_GYP_FORCE_PYTHON) {
           return [{
             before: () => {
-              this.addLog('checking Python explicitly set from NODE_GYP_FORCE_PYTHON');
-              this.addLog('- process.env.NODE_GYP_FORCE_PYTHON is ' + `"${this.env.NODE_GYP_FORCE_PYTHON}"`);
+              this.addLog('检查是否通过 NODE_GYP_FORCE_PYTHON 显式指定 Python');
+              this.addLog('- process.env.NODE_GYP_FORCE_PYTHON 为 ' + `"${this.env.NODE_GYP_FORCE_PYTHON}"`);
             }, check: () => this.checkCommand(this.env.NODE_GYP_FORCE_PYTHON)
           }];
         }
@@ -87,21 +87,21 @@ class PythonFinder {
           {
             before: () => {
               if (!this.configPython) {
-                this.addLog('Python is not set from command line or npm configuration');
+                this.addLog('未从命令行或 npm 配置指定 Python');
                 return SKIP;
               }
-              this.addLog('checking Python explicitly set from command line or ' + 'npm configuration');
-              this.addLog('- "--python=" or "npm config get python" is ' + `"${this.configPython}"`);
+              this.addLog('检查是否从命令行或 npm 配置显式指定 Python');
+              this.addLog('- "--python=" 或 "npm config get python" 的值为 ' + `"${this.configPython}"`);
             }, check: () => this.checkCommand(this.configPython)
           },
           {
             before: () => {
               if (!this.env.PYTHON) {
-                this.addLog('Python is not set from environment variable ' + 'PYTHON');
+                this.addLog('未从环境变量 PYTHON 指定 Python');
                 return SKIP;
               }
-              this.addLog('checking Python explicitly set from environment ' + 'variable PYTHON');
-              this.addLog(`- process.env.PYTHON is "${this.env.PYTHON}"`);
+              this.addLog('检查是否从环境变量 PYTHON 显式指定 Python');
+              this.addLog(`- process.env.PYTHON 为 "${this.env.PYTHON}"`);
             },
             check: () => this.checkCommand(this.env.PYTHON)
           }
@@ -110,23 +110,23 @@ class PythonFinder {
         if (this.win) {
           for (const launcher of pyLauncherCandidates) {
             checks.push({
-              before: () => this.addLog(`checking if "${launcher}" can be used to find Python 3`),
+              before: () => this.addLog(`检查能否用 "${launcher}" 查找 Python 3`),
               check: () => this.checkPyLauncher(launcher)
             });
           }
           checks.push({
-            before: () => this.addLog('enumerating installed Pythons via "py -0p"'),
+            before: () => this.addLog('通过 "py -0p" 枚举已安装的 Python'),
             check: () => this.checkPyList()
           });
         }
 
         checks.push(...[
           {
-            before: () => { this.addLog('checking if "python3" can be used'); },
+            before: () => { this.addLog('检查能否使用 "python3"'); },
             check: () => this.checkCommand('python3')
           },
           {
-            before: () => { this.addLog('checking if "python" can be used'); },
+            before: () => { this.addLog('检查能否使用 "python"'); },
             check: () => this.checkCommand('python')
           }
         ]);
@@ -135,7 +135,7 @@ class PythonFinder {
           for (let i = 0; i < this.winDefaultLocations.length; ++i) {
             const location = this.winDefaultLocations[i];
             checks.push({
-              before: () => this.addLog(`checking if Python is ${location}`),
+              before: () => this.addLog(`检查 Python 是否位于 ${location}`),
               check: () => this.checkExecPath(location)
             });
           }
@@ -160,33 +160,33 @@ class PythonFinder {
 
   // 检查命令是否为可用的 Python;
   async checkCommand(command) {
-    this.log.verbose(`- executing "${command}" to get executable path`);
+    this.log.verbose(`- 执行 "${command}" 以获取可执行文件路径`);
     try {
       const execPath = await this.run(command, this.argsExecutable, false);
-      this.addLog(`- executable path is "${execPath}"`);
+      this.addLog(`- 可执行文件路径为 "${execPath}"`);
       return this.checkExecPath(execPath);
     } catch (err) {
-      this.addLog(`- "${command}" is not in PATH or produced an error`);
+      this.addLog(`- "${command}" 不在 PATH 中或执行出错`);
       throw err;
     }
   }
 
   // 检查指定 py 启动器是否能找到 Python 3;
   async checkPyLauncher(launcher = this.pyLauncher) {
-    this.log.verbose(`- executing "${launcher}" to get Python 3 executable path`);
+    this.log.verbose(`- 执行 "${launcher}" 以获取 Python 3 可执行文件路径`);
     try {
       const execPath = await this.run(launcher, ['-3', ...this.argsExecutable], false);
-      this.addLog(`- executable path is "${execPath}"`);
+      this.addLog(`- 可执行文件路径为 "${execPath}"`);
       return this.checkExecPath(execPath);
     } catch (err) {
-      this.addLog(`- "${launcher}" is not in PATH or produced an error`);
+      this.addLog(`- "${launcher}" 不在 PATH 中或执行出错`);
       throw err;
     }
   }
 
   // 通过 "py -0p" 枚举所有已注册的 Python,覆盖非标准安装位置;
   async checkPyList() {
-    this.log.verbose('- executing "py -0p" to list registered Pythons');
+    this.log.verbose('- 执行 "py -0p" 以列出已注册的 Python');
     let lastErr;
     for (const launcher of pyLauncherCandidates) {
       try {
@@ -196,29 +196,29 @@ class PythonFinder {
           const m = line.match(/([A-Za-z]:\\[^\s]+)/);
           if (m && /python\.exe$/i.test(m[1])) paths.push(m[1]);
         }
-        this.addLog(`- "py -0p" (via ${launcher}) found ${paths.length} path(s)`);
+        this.addLog(`- "py -0p" (via ${launcher}) 找到 ${paths.length} 个路径`);
         for (const p of paths) {
           try {
             return await this.checkExecPath(p);
           } catch (err) {
             lastErr = err;
-            this.log.silly('checkPyList: skipping %s: %s', p, err.message);
+            this.log.silly('checkPyList: 跳过 %s: %s', p, err.message);
           }
         }
       } catch (err) {
         lastErr = err;
-        this.addLog(`- "py -0p" via "${launcher}" failed`);
+        this.addLog(`- 经 "${launcher}" 执行 "py -0p" 失败`);
       }
     }
-    throw lastErr || new Error('py -0p returned no usable Python');
+    throw lastErr || new Error('py -0p 未返回可用的 Python');
   }
 
   // 检查某个 Python 可执行文件版本是否可用;
   async checkExecPath(execPath) {
-    this.log.verbose(`- executing "${execPath}" to get version`);
+    this.log.verbose(`- 执行 "${execPath}" 以获取版本`);
     try {
       const version = await this.run(execPath, this.argsVersion, false);
-      this.addLog(`- version is "${version}"`);
+      this.addLog(`- 版本为 "${version}"`);
 
       const range = new semver.Range(this.semverRange);
       let valid = false;
@@ -226,18 +226,18 @@ class PythonFinder {
         valid = range.test(version);
       } catch (err) {
         this.log.silly('range.test() threw:\n%s', err.stack);
-        this.addLog(`- "${execPath}" does not have a valid version`);
-        this.addLog('- is it a Python executable?');
+        this.addLog(`- "${execPath}" 的版本无效`);
+        this.addLog('- 它是不是 Python 可执行文件?');
         throw err;
       }
       if (!valid) {
-        this.addLog(`- version is ${version} - should be ${this.semverRange}`);
-        this.addLog('- THIS VERSION OF PYTHON IS NOT SUPPORTED');
-        throw new Error(`Found unsupported Python version ${version}`);
+        this.addLog(`- 版本为 ${version},应为 ${this.semverRange}`);
+        this.addLog('- 此版本的 Python 不受支持');
+        throw new Error(`不支持的 Python 版本 ${version}`);
       }
       return this.succeed(execPath, version);
     } catch (err) {
-      this.addLog(`- "${execPath}" could not be run`);
+      this.addLog(`- "${execPath}" 无法运行`);
       throw err;
     }
   }
@@ -251,9 +251,9 @@ class PythonFinder {
     this.log.silly('execFile: args = %j', args);
     this.log.silly('execFile: opts = %j', opts);
     const [err, stdout, stderr] = await this.execFile(exec, args, opts);
-    this.log.silly('execFile result: err = %j', (err && err.stack) || err);
-    this.log.silly('execFile result: stdout = %j', stdout);
-    this.log.silly('execFile result: stderr = %j', stderr);
+    this.log.silly('execFile 结果: 错误 = %j', (err && err.stack) || err);
+    this.log.silly('execFile 结果: 标准输出 = %j', stdout);
+    this.log.silly('execFile 结果: 标准错误 = %j', stderr);
     if (err) throw err;
     return stdout.trim();
   }
@@ -268,15 +268,15 @@ class PythonFinder {
       pathExample = this.win ? 'C:\\Path\\To\\python.exe' : '/path/to/pythonexecutable',
       info = [
         '**********************************************************',
-        'You need to install the latest version of Python.',
-        'Node-gyp should be able to find and use Python. If not,',
-        'you can try one of the following options:',
-        `- Use the switch --python="${pathExample}"`,
-        '  (accepted by both node-gyp and npm)',
-        '- Set the environment variable PYTHON',
-        '- Set the npm configuration variable python:',
+        '需要安装最新版本的 Python;',
+        '应能自动找到并使用 Python;若找不到,',
+        '可尝试以下任一方式:',
+        `- 使用 --python="${pathExample}" 开关`,
+        '  (npm 与本包均接受该参数)',
+        '- 设置环境变量 PYTHON',
+        '- 设置 npm 配置项 python:',
         `  npm config set python "${pathExample}"`,
-        'For more information consult the documentation at:',
+        '更多说明见文档:',
         'https://github.com/nodejs/node-gyp#installation',
         '**********************************************************'
       ].join('\n');