Yarn安装html-to-text等模块成功后引入仍报找不到模块错误如何解决

问题排查解决步骤 #

1. 验证模块解析路径是否正常 #

• 在项目根目录新建test-path.js，写入以下代码后执行node test-path.js：

console.log(module.paths)

确认输出的路径列表包含当前项目的node_modules目录绝对路径。如果缺失，大概率是当前执行命令的工作目录不对，或者项目路径包含中文、特殊符号、空格导致Node.js解析路径异常。

• 确认执行Node脚本的工作目录就是项目根目录（与package.json、node_modules同级），不要在子目录下直接执行入口文件，除非你提前配置了NODE_PATH环境变量指向项目依赖目录。

2. 清理并重新安装依赖 #

• 执行以下命令清理缓存重装所有依赖，解决依赖文件损坏、安装不完整的问题：

# 清理yarn全局缓存
yarn cache clean
# 删除现有依赖目录与锁文件
# Mac/Linux执行：
rm -rf node_modules yarn.lock
# Windows执行：
rd /s /q node_modules
del yarn.lock
# 重新全量安装依赖
yarn install

• 安装完成后手动打开node_modules目录，确认html-to-text目录存在，且目录下包含合法的package.json与入口文件。
• 执行yarn install --check-files验证依赖文件与锁文件声明是否一致，有异常会自动修复。

3. 检查项目模块规范与工具配置 #

• 先做原生Node引入测试，排除打包工具配置问题：在项目根目录新建test-import.js，写入你的引入代码：

const { convert } = require('html-to-text');
console.log('引入成功', !!convert);

执行node test-import.js，如果能正常输出，说明问题出在你用的Webpack/Vite/Rollup等打包工具配置上，检查打包工具的resolve.modules、resolve.alias等配置，是否修改了默认的模块查找路径。

• 检查package.json的type字段，如果配置了"type": "module"，说明项目采用ES模块规范，不支持require语法，需要改成ES导入写法：

import { convert } from 'html-to-text';

• 检查项目根目录是否存在.npmrc、.yarnrc配置文件，确认其中没有配置错误的modules-folder、prefix参数，导致依赖被安装到非默认目录。

4. 校验Node.js版本兼容性 #

• 对比当前Windows设备与正常运行的Mac设备的Node.js版本，执行node -v查看版本号，如果版本差异过大，部分新依赖可能不兼容低版本Node，建议用nvm（Windows用nvm-windows）切换到和Mac设备一致的Node.js版本后，重新装包测试。

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