求助：调用工具函数时出现Cannot find module 'src/utils/validateRegister'错误

我之前也碰到过一模一样的情况——本地IDE能正常识别模块，一跑yarn dev就报找不到模块的错！这种问题大多和模块路径解析配置、文件大小写或者缓存有关，给你几个实用的排查和解决方向：

1. 确认项目的路径别名配置是否生效 #

本地IDE（比如VS Code）会自动识别项目根目录，但开发服务器（Vite、Webpack等）需要手动配置路径别名才能识别src/...这种绝对路径导入：

• 如果是TypeScript项目，检查tsconfig.json的compilerOptions：

  {
    "compilerOptions": {
      "baseUrl": "./",
      "paths": {
        "src/*": ["src/*"]
      }
    }
  }
  

• 同时要给开发工具单独配置别名，比如Vite的vite.config.js：

  import { defineConfig } from 'vite'
  import path from 'path'
  
  export default defineConfig({
    resolve: {
      alias: {
        'src': path.resolve(__dirname, './src')
      }
    }
  })
  

  Webpack的话则要配置resolve.alias字段，原理类似。

2. 检查文件名大小写是否一致 #

Windows系统是大小写不敏感的，但如果你的开发服务器跑在Linux/macOS（或者用了WSL），文件名大小写会严格区分。比如你导入的是validateRegister.js，但实际文件名叫Validateregister.js，本地IDE能找到，但服务器会直接报错找不到模块。

3. 清除缓存并重启开发服务器 #

有时候工具会缓存旧的模块解析结果，导致修改配置后不生效：

• 先停止yarn dev进程
• 删除工具的缓存目录：比如Vite的node_modules/.cache，Webpack的dist或者缓存文件夹
• 重新执行yarn dev

4. 验证导入路径的正确性 #

如果你没配置路径别名，应该用相对路径导入而不是src/...的绝对路径。比如你的文件在src/components/Register.vue，正确的相对路径应该是../utils/validateRegister，而不是src/utils/validateRegister。

5. 检查package.json的模块类型配置 #

如果你的package.json里设置了"type": "module"，确保你的导入语句符合ES模块规范（比如不要混用require，路径后缀的规则要匹配——不过大多数前端框架会帮你处理后缀，但还是要留意）。

这些方法应该能帮你解决问题，我当时就是因为Vite没配置路径别名，导致本地IDE识别但开发服务器不认，配置完就正常了！

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