Error: Cannot find module ‘@/xxx‘

在 Node.js 中遇到 `Error: Cannot find module './utils'` 错误通常是因为模块路径不正确或者文件不存在。以下是可能的原因以及解决方案： ### 可能原因及解决方法 #### 1. 文件路径错误 如果 `./utils` 路径指定有误，Node.js 将无法找到对应的模块。 - **确认路径**：确保 `utils.js` 或者 `utils/index.js` 存在于当前脚本所在的目录下[^1]。 - 如果不在同一目录，则需调整相对路径。例如： ```javascript const utils = require('../utils'); // 上一层目录中的 utils 文件夹或文件 ``` #### 2. 文件名大小写敏感 某些操作系统（如 Linux 和 macOS）对文件名区分大小写，而 Windows 不区分。因此，在跨平台开发时可能会引发此问题。 - **检查命名一致性**：确保导入语句中的名称与实际文件名完全一致。 #### 3. 缺少默认导出 即使路径无误，也可能因为未正确定义模块内容而导致加载失败。 - **验证 exports 定义**：打开 `utils.js` 并确认其具有有效的 `module.exports` 或 `exports.xxx` 声明[^2]。 ```javascript // 正确示例 module.exports = { add: function(a, b) { return a + b; } }; // 使用方式 const utils = require('./utils'); console.log(utils.add(1, 2)); // 输出 3 ``` #### 4. Babel 配置不当影响 CommonJS 支持 当项目使用 ES6+ 特性和 Babel 进行转译时，可能出现兼容性问题。 - **检查 babel.config.json 或 .babelrc 设置**：确保启用了 `@babel/preset-env` 插件来支持 CommonJS 模块语法[^3]。 ```json { "presets": ["@babel/preset-env"] } ``` #### 5. Webpack 打包遗漏依赖项 对于基于 Webpack 构建的应用程序来说，打包过程中如果没有正确处理外部依赖关系也会报此类错。 - **优化 loader 规则**：参照引用说明完善资源匹配规则[^1]^。 ```javascript rules:[ ... {test:/\.less$/,use:['style-loader','css-loader','less-loader']}, {test:/\.(ttf|woff|woff2)$/,type:'asset/resource'} ] ``` 通过以上分析可以定位并修复大多数情况下发生的找不到本地自定义模块的情况。 ```javascript try{ let utilFuncs=require("./utils"); }catch(err){ if(err.code==='MODULE_NOT_FOUND'){ console.error('Please check the existence and path of your "./utils" file.'); }else throw err; } ```