WebStorm默认只识别项目根目录的webpack.config.js等配置文件；若在子目录需手动指定路径并重载，且alias必须用path.resolve()、tsconfig.json需配baseUrl和paths并启用路径映射。
Webpack配置文件不在根目录，WebStorm完全不识别
WebStorm 默认只扫描项目根目录（即 package.json 所在层）下的 webpack.config.js、webpack.config.cjs 或 webpack.config.mjs。放在 config/webpack.config.js 或 build/webpack.base.js 这类路径里，IDE 就当它不存在——不解析 alias、不补全路径、Ctrl+Click 别名直接失效。
最稳的解法是把配置文件移到和 package.json 同级目录。如果因团队规范或脚手架约束必须放子目录，就进 Settings → Languages & Frameworks → JavaScript → Webpack，手动填入完整路径，例如：config/webpack.config.js。填完后务必点右上角的 Reload configuration，否则缓存照旧生效。
手动指定路径后 alias 仍不跳转
WebStorm 读到配置 ≠ 它能理解 resolve.alias。它不会执行 path.resolve()，也不解析 require('path').join()，只做静态分析，且只信任 tsconfig.json 中的 paths 映射。
-
webpack.config.js中 alias 值必须是path.resolve(__dirname, 'src')这种绝对路径写法，不能写'./src'或__dirname + '/src' -
tsconfig.json必须有合法的baseUrl和paths，例如：{"baseUrl": "./src", "paths": {"@/*": ["*"]}}；baseUrl不能是src或/src，paths的 key 必须以/结尾 - WebStorm 设置中要勾选 Use paths mapping from tsconfig.json，然后点击右下角 TypeScript 图标 → Restart TypeScript Service
Vue CLI / Vite 项目根本没 webpack.config.js，怎么配
Vue CLI 3+ 和 Vite 不暴露标准 Webpack 配置文件，它们的别名由 vue.config.js 或 vite.config.ts 中的 resolve.alias 控制——但 WebStorm 不读这些文件。
可行做法是：在项目根目录新建一个仅用于 IDE 的 webpack.config.js，内容只导出 alias 配置：
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
const path = require('path');
module.exports = {
resolve: {
alias: {
'@': path.resolve(__dirname, 'src'),
'@api': path.resolve(__dirname, 'src/api')
}
}
};
这个文件不用参与实际构建，只要让 WebStorm 能加载 alias 即可。注意别名值仍需用 path.resolve()，且确保已安装 @types/node（npm install @types/node --save-dev），否则 TS 会忽略整个 paths 配置。
“Cannot find module 'webpack'” 报错不是路径问题
这个错误常被误认为是 WebStorm 配置路径不对，其实是运行环境缺失：Webpack 5+ 已将 webpack 和 webpack-cli 拆成两个独立包，只装 webpack-cli 是不够的。
必须本地安装完整依赖：
npm install --save-dev webpack webpack-cli- 或
yarn add -D webpack webpack-cli - pnpm 用户注意路径：WebStorm 的 Run Configuration 中，
webpack package应指向node_modules/.pnpm/webpack@*/node_modules/webpack/bin/webpack.js，别手输，用文件选择器点选
配置完不 reload、alias 写对了但没配 tsconfig.json、或者用了 Vite 却硬塞 require() —— 这些才是真坑，比路径填错更难排查。
