为何npm无法require我的本地测试模块？求助排查

看起来你遇到的问题是本地测试npm模块时，能通过相对路径加载但无法通过模块名加载，我来帮你分析几个常见原因和解决方法：

1. 检查package.json的main字段路径是否正确 #

你的package.json里main字段设置为"./lib/index"，但如果你的index.js是放在模块的根目录（而不是lib文件夹下），这个路径就不存在了。

当你用相对路径require('./node_modules/mystuff')时，Node.js会做降级处理：如果package.json的main指向的文件找不到，它会自动尝试加载目录下的index.js，所以这时候能成功。但用模块名require('mystuff')时，Node.js会严格按照main字段的路径去查找，找不到就直接报错。

解决方法：
修改package.json的main字段为你的实际入口文件路径：

{
  "name": "mystuff",
  "version": "0.0.1",
  "description": "",
  "main": "./index.js", // 或者直接写"index.js"
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "MIT"
}

2. 确保本地模块是通过正确方式安装的 #

如果只是手动把模块文件夹复制到node_modules里，Node.js的模块解析系统可能无法正确识别它。推荐用官方的本地安装方式：

方法一：使用npm install本地路径 #

在你的测试项目目录下，执行：

npm install /path/to/your/mystuff-folder

这会在node_modules里创建正确的模块引用，确保Node.js能通过模块名找到它。

方法二：使用npm link（适合频繁修改模块的场景） #

1. 先在你的mystuff模块目录下执行：

npm link

这会把模块全局链接到npm的全局模块目录。
2. 然后在测试项目目录下执行：

npm link mystuff

这会在测试项目的node_modules里创建一个指向你本地模块的软链接，修改模块代码后无需重新安装，直接测试即可。

3. 清除Node.js模块缓存 #

有时候Node.js会缓存之前的模块加载失败状态，导致即使修复了问题也无法立即加载。可以通过以下方式清除缓存：

• 重启你的Node.js环境（比如退出REPL再重新进入）
• 或者在REPL里执行：

delete require.cache[require.resolve('mystuff')]

然后再尝试require('mystuff')。

4. 确认模块名和文件夹名完全一致 #

Node.js的模块查找是大小写敏感的，确保：

• package.json里的name字段是"mystuff"
• 测试项目node_modules里的文件夹名也是mystuff（注意大小写，比如不要写成MyStuff）

按照上面的步骤排查，应该就能解决无法通过模块名加载的问题了。

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