已安装javro模块但Node.js运行时提示找不到模块的问题求助

我对Node.js不熟悉，已经执行npm install --save-dev javro成功安装了javro开发依赖，但运行convert.js文件时，Node.js抛出Cannot find module 'javro'错误。convert.js代码来自javro的官方使用示例。

操作及错误日志： #

>:~/personal/schematosis# npm install --save-dev javro

up to date, audited 73 packages in 1s

13 packages are looking for funding
  run `npm fund` for details

found 0 vulnerabilities
>:~/personal/schematosis# node convert.js             
node:internal/modules/cjs/loader:998
  throw err;
  ^

Error: Cannot find module 'javro'
Require stack:
- <HOME>/personal/schematosis/convert.js
    at Module._resolveFilename (node:internal/modules/cjs/loader:995:15)
    at Module._load (node:internal/modules/cjs/loader:841:27)
    at Module.require (node:internal/modules/cjs/loader:1061:19)
    at require (node:internal/modules/cjs/helpers:103:18)
    at Object.<anonymous> (<HOME>/personal/schematosis/convert.js:1:45)
    at Module._compile (node:internal/modules/cjs/loader:1159:14)
    at Module._extensions..js (node:internal/modules/cjs/loader:1213:10)
    at Module.load (node:internal/modules/cjs/loader:1037:32)
    at Module._load (node:internal/modules/cjs/loader:878:12)
    at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:81:12) {
  code: 'MODULE_NOT_FOUND',
  requireStack: [ 'HOME/schematosis/convert.js' ]
}

Node.js v18.11.0

原因分析 #

• Node.js默认仅从package.json的dependencies字段加载运行时所需模块，--save-dev安装的包会被归类到devDependencies，仅用于开发阶段（如构建、测试），常规node命令运行脚本时不会识别该字段下的包。
• 你的convert.js直接通过require('javro')引用模块，但该包仅作为开发依赖存在，导致运行时无法找到。

解决方法 #

1. 将javro安装为生产依赖（推荐）

执行以下命令，把包移到dependencies字段，Node.js运行时即可正常查找：

npm install javro

2. 通过npm脚本运行（适合保留开发依赖的场景）

如果convert.js是构建流程的一部分，无需修改依赖类型，只需在package.json中添加脚本：

"scripts": {
  "convert": "node convert.js"
}

然后通过npm命令运行脚本：

npm run convert

npm运行脚本时会自动包含node_modules/.bin路径，并允许访问devDependencies下的模块。

3. 临时指定模块路径（仅测试用）

通过NODE_PATH环境变量临时指定模块查找目录，不推荐用于生产环境：

NODE_PATH=./node_modules node convert.js

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