WebStorm仅识别项目根目录下的webpack.config.js、webpack.config.cjs或webpack.config.mjs中的resolve.alias；别名值须为path.resolve()生成的绝对路径，并需在tsconfig.json中同步配置paths以支持TS跳转与类型检查。
Webpack alias 配置必须放在 webpack.config.js 里才能被 WebStorm 识别
WebStorm 不会读取 alias.config.js 或其他任意命名的配置文件，它只认标准入口：项目根目录下的 webpack.config.js、webpack.config.cjs 或 webpack.config.mjs。如果你把 alias 写在单独的 alias.config.js 里再 require 进去，WebStorm 无法解析这个间接引用，路径补全就失效。
正确做法是直接在 webpack.config.js 的 resolve.alias 中声明：
const path = require('path');
module.exports = {
resolve: {
alias: {
'@': path.resolve(__dirname, 'src'),
'@api': path.resolve(__dirname, 'src/api'),
'_c': path.resolve(__dirname, 'src/components')
}
}
};
- 必须用
path.resolve()，不能用__dirname + '/src'这类字符串拼接（WebStorm 解析不了） - 别名值必须是绝对路径，相对路径如
'./src'会被忽略 - 如果项目用了 TypeScript，还要同步在
tsconfig.json的compilerOptions.paths里配一遍，否则 TS 类型检查和跳转会断
WebStorm 要求 webpack.config.js 在项目根目录
即使配置写对了，如果 webpack.config.js 放在 config/ 或 build/ 子目录下，WebStorm 默认完全不扫描——它不会递归查找，也不会自动识别你手动 import 的配置文件。
两种解决方式：
- 把
webpack.config.js移到和package.json同级的项目根目录（推荐） - 如果必须放子目录，进
Run > Edit Configurations…新建一个 Node.js 配置：
– Working directory 设为项目根目录
– JavaScript file 填完整路径，例如config/webpack.config.js
– 确保node_modules/webpack和node_modules/webpack-cli已本地安装（不是全局）
没装本地依赖时，WebStorm 会报 Cannot find module 'webpack'，这不是路径问题，是运行环境缺失。
补全生效前要确认 IDE 已加载 Webpack 支持
WebStorm 不是“配完 alias 就立刻补全”，它需要明确知道你在用 Webpack。这个识别动作只在满足以下条件时触发：
- 项目根目录存在被识别的 Webpack 配置文件（见上一条）
- Settings → Languages & Frameworks → JavaScript → Webpack 页面中，
Webpack package指向了本地node_modules/webpack（不是全局） -
Configuration file字段已自动填入或手动选中你的webpack.config.js
如果字段为空或显示 “Not found”，说明 WebStorm 根本没发现配置文件，先回去检查路径和文件名。改完配置后不需要重启 IDE，但要等右下角状态栏出现 “Webpack config loaded” 提示才真正生效。
补全不出现？优先检查省电模式和代码完成设置
即使 Webpack 配置完全正确，补全也可能静默失败——最常见原因是省电模式（Power Save Mode）开着，它会禁用所有智能辅助，包括路径提示。
快速排查步骤：
- 右下角图标区域点开，确认
Power Save Mode未勾选 - Settings → Editor → General → Code Completion → 勾选
Autopopup code completion，延迟设为0或 ≤200ms - 输入
import xxx from '@后停顿半秒，看是否弹出补全框；没反应就按Ctrl+Space手动触发 - 补全列表里如果只有文件名没有路径结构（比如只列
index.js，不显示@/components/Button.vue），说明 alias 未被识别，回退检查前三个环节
alias 补全是 WebStorm 基于 Webpack 配置做的静态推导，不运行打包过程，所以别指望它能识别动态拼接的路径（如 require(`@/views/${name}`)）——这种写法本身也不该出现在生产配置里。
