JSDocs (更好的文档)'NODE_ENV'不被识别为内部或外部命令、可操作程序或批处理文件。

Question

我正试图用组件插件配置更好的docs，使用他们的官方的 github教程

由于某些原因，我收到一个奇怪的错误。

Parsing D:\Projects\train-time\src\stories\StoryContainer.tsx ...
Generating output files...
Generating entry file for "components" plugin
Bundling components
running: NODE_ENV=development parcel build docs\entry.js --out-dir docs\build
'NODE_ENV' is not recognized as an internal or external command,
operable program or batch file.

D:\Projects\train-time\node_modules\better-docs\bundler.js:91
    throw error
    ^

Error: Command failed: NODE_ENV=development parcel build docs\entry.js --out-dir docs\build
'NODE_ENV' is not recognized as an internal or external command,
operable program or batch file.

    at checkExecSyncError (child_process.js:630:11)
    at execSync (child_process.js:666:15)
    at bundle (D:\Projects\train-time\node_modules\better-docs\bundler.js:86:5)
    at Object.exports.publish (D:\Projects\train-time\node_modules\better-docs\publish.js:699:3)
    at Object.module.exports.cli.generateDocs (D:\Projects\train-time\node_modules\jsdoc\cli.js:441:39)
    at Object.module.exports.cli.processParseResults (D:\Projects\train-time\node_modules\jsdoc\cli.js:392:24)
    at module.exports.cli.main (D:\Projects\train-time\node_modules\jsdoc\cli.js:235:18)
    at Object.module.exports.cli.runCommand (D:\Projects\train-time\node_modules\jsdoc\cli.js:186:9)
    at D:\Projects\train-time\node_modules\jsdoc\jsdoc.js:93:9
    at Object.<anonymous> (D:\Projects\train-time\node_modules\jsdoc\jsdoc.js:94:3)
    at Module._compile (internal/modules/cjs/loader.js:1138:30)
    at Object.Module._extensions..js (internal/modules/cjs/loader.js:1158:10)
    at Module.load (internal/modules/cjs/loader.js:986:32)
    at Function.Module._load (internal/modules/cjs/loader.js:879:14)
    at Function.executeUserEntryPoint [as runMain] (internal/modules/run_main.js:71:12)
    at internal/main/run_main_module.js:17:47 {
  status: 1,
  signal: null,
  output: [
    null,
    <Buffer >,
    <Buffer 27 4e 4f 44 45 5f 45 4e 56 27 20 69 73 20 6e 6f 74 20 72 65 63 6f 67 6e 69 7a 65 64 20 61 73 20 61 6e 20 69 6e 74 65 72 6e 61 6c 20 6f 72 20 65 78 74 ... 49 more bytes>
  ],
  pid: 2928,
  stdout: <Buffer >,
  stderr: <Buffer 27 4e 4f 44 45 5f 45 4e 56 27 20 69 73 20 6e 6f 74 20 72 65 63 6f 67 6e 69 7a 65 64 20 61 73 20 61 6e 20 69 6e 74 65 72 6e 61 6c 20 6f 72 20 65 78 74 ... 49 more bytes>
}
npm ERR! code ELIFECYCLE
npm ERR! errno 1
npm ERR! [email protected] doc: `jsdoc -c jsdoc.json`
npm ERR! Exit status 1
npm ERR!
npm ERR! Failed at the [email protected] doc script.
npm ERR! This is probably not a problem with npm. There is likely additional logging output above.

有谁知道这个错误是什么意思，从NODE_ENV哪里来的？我在项目中没有使用任何NODE_ENV。

Answer 1

该脚本的创建者认为你使用的是一个名为 sh-壳状 bash 或 zsh;Windows的shell显然与这种设置环境变量的方式不兼容。

我建议安装 cross-env 作为开发依赖。这让你可以用一种跨平台的方式设置环境变量，类似于sh-like模式的变量设置。例如，在一个 package.json 脚本。

"build": "cross-env NODE_ENV=development parcel build docs\entry.js --out-dir docs\build"