# Webpack

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

CLion 与 [webpack](https://webpack.js.org/) 模块打包工具集成。 此支持通过考虑 [webpack module resolution](https://webpack.js.org/concepts/module-resolution/)和 [resolve aliases](https://webpack.js.org/configuration/resolve/)来改进JavaScript文件中的代码辅助功能。

在包含多个具有不同 webpack 配置的模块的项目中，CLion 可以自动检测每个模块的相关配置文件并使用其中的模块解析规则，请参阅下文的 [Specifying the webpack configuration file to use](#specify_webpack_configuration_file_auto_detection)。

对于 webpack 2 版本及更高版本，CLion 为 webpack 配置文件中的选项提供代码补全和快速文档查阅功能。

## 在开始之前

Procedure:

1. 请确保您的计算机上安装了 [Node.js](http://nodejs.org/)。

2. 确保  JavaScript 和 TypeScript  以及  Webpack  所需插件已在   设置 | 插件   页面上启用。 有关更多信息，请参阅 [管理插件](managing-plugins.html)。

## 在 CLion 中配置 webpack

Procedure: 将 webpack 添加到您的 package.json

* 确保 webpack 列在  `dependencies`  或  `devDependencies`  对象的  `package.json`  中。

如果缺少 webpack，请打开命令行 shell 或嵌入的   终端  （ `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))），然后输入：

`npm install --save-dev webpack`

Procedure: 创建 webpack 配置文件

* 根据您的项目结构创建一个或多个配置文件：在   项目  工具窗口( `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)))中选择一个父文件夹，然后从上下文菜单中选择  `新建 | JavaScript 文件` 。 从 [webpack 官方网站](https://webpack.js.org/guides/getting-started/#using-a-configuration)了解更多信息。

### 指定要使用的 webpack 配置文件

基于对 webpack 配置文件的分析，CLion 理解 webpack 配置，解析模块，并在 JavaScript 文件中提供代码辅助，请参阅下文中的 [解析模块](#webpack_module_resolution)。

在 CLion 中，您可以选择两种配置模式——自动和手动。

使用 [自动配置](#specify_webpack_configuration_file_auto_detection_procedure)，CLion 会自动检测每个 JavaScript 文件的相关 webpack 配置文件。

通过 [手动配置](#specify_webpack_configuration_file_manual)，您可以指定项目中使用的 webpack 配置文件。 如果 CLion 无法识别您的 webpack 配置文件的名称，则可以使用手动配置，参考下面的 [已识别的 webpack 配置名称列表](#specify_webpack_configuration_recognized_names)。

Procedure: 选择如何检测 webpack 配置

1. 打开   设置  对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），然后转到  `语言与框架 | JavaScript | Webpack` 。

2. 在   检测 Webpack 配置文件以进行模块解析  区域，选择以下选项之一：

* 自动： 在此模式下，对于 JavaScript 文件，CLion 将首先在此 JavaScript 文件所在的文件夹中查找 webpack 配置文件，然后在其上级文件夹中查找，依此类推。 因此，如果您的项目包含多个具有不同 webpack 配置的模块，则每个模块都将使用其自己的 webpack 配置文件中的模块解析规则（如果找到了这样的配置）。 CLion 识别以下名称和顺序的 JavaScript 或 TypeScript webpack 配置文件： * `webpack.config.js` / `webpack.config.ts` * `webpack.base.conf.js` / `webpack.base.conf.ts` * `webpack.dev.conf.js` / `webpack.dev.conf.ts` * `webpack.prod.conf.js` / `webpack.prod.conf.ts` * `webpack.base.config.js` / `webpack.base.config.ts` * `webpack.dev.config.js` / `webpack.dev.config.ts` * `webpack.prod.config.js` / `webpack.prod.config.ts` * `webpack.babel.js` / `webpack.babel.ts`

* 手动： 在 配置文件 字段中，指定要使用的 webpack 配置的位置。 在这种模式下，指定配置文件中的解析规则将应用于项目中的所有模块。 如果您的 webpack 配置文件名称未被 CLion 识别，请参考上面的 [已识别的 webpack 配置名列表](#specify_webpack_configuration_recognized_names)。

亦请参阅 webpack 官方网站上的 [入门指南](https://webpack.js.org/guides/getting-started/)。

## 编辑 webpack 配置文件

对于 webpack 版本 2 及更高版本，CLion 在 webpack 配置文件的配置对象中提供代码补全和文档查找。 自动提供代码补全。 若要查看符号的文档，请按 `Ctrl+Q` (Windows), `F1` (macOS), `⌃ J` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Ctrl+Q` (XWin), `Ctrl+Q` (GNOME), `Ctrl+Q` (KDE), `Ctrl+Q` (Emacs), `Ctrl+Q` (Sublime Text), `Ctrl+Q` (Sublime Text (macOS)), `⌘ ⌃ ⇧ /` (Xcode), `Ctrl+K, I` (Visual Studio), `⌘ K, I` (Visual Studio (macOS)), `Ctrl+Q` (ReSharper), `⌃ Q` (ReSharper (macOS)), `Ctrl+Q` (QtCreator), `Ctrl+Q` (QtCreator (macOS)), `Ctrl+Q` (NetBeans), `Alt+Middle-Click` (Eclipse), `⌥ Middle-Click` (Eclipse (macOS))。

![编辑 webpack 配置文件](https://resources.jetbrains.com/help/img/idea/2026.3/ws_webpack-conf.png)

> **Tip:**
> CLion 仅在其名称包含  `webpack` 字符串且在  `package.json` 中列出 webpack 时，才会在 webpack 配置文件中提供代码帮助。

## 解决模块

当您打开一个项目或编辑一个 webpack 配置文件（无论是 [自动检测](#specify_webpack_configuration_file_auto_detection)的还是在   设置 | 语言与框架 | JavaScript | Webpack  上指定的），CLion将在后台分析配置，并根据接收到的信息，正确理解项目的 [resolve roots](https://webpack.js.org/concepts/module-resolution)和 [resolve aliases](https://webpack.js.org/configuration/resolve/)。 由于对项目配置的理解，CLion 能够为 JavaScript 文件中的导入和导出符号提供更精确的代码补全。 因此，一切都能正常工作，无需您采取任何步骤。

下图说明了在一个项目中  `utils`  作为路径  `'my_sources/util'`  的别名时的模块解析。 CLion 能够正确解析来自  `@util/formatMessage.js`  的导入，提供导航并为导出的符号提供补全：

![别名模块解析](https://resources.jetbrains.com/help/img/idea/2026.3/ws_webpack-alias.png)

## 调试 使用 webpack 的应用程序

您可以调试使用 webpack 的应用程序，就像调试任何 JavaScript 客户端应用程序一样，请参阅 [调试使用 Create React App 创建的 React 应用](https://blog.jetbrains.com/webstorm/2017/01/debugging-react-apps/)和 [调试使用 Angular CLI 创建的 Angular 应用](https://blog.jetbrains.com/webstorm/2017/01/debugging-angular-apps/)。

## See also

### Web 资源

[Support for webpack enhanced module resolution in CLion](https://blog.jetbrains.com/webstorm/2017/06/webstorm-2017-2-eap-172-2827/) [Completion in webpack 2 configuration files](https://blog.jetbrains.com/webstorm/2017/04/webstorm-2017-1-1/)

### 外部链接

[Getting started with webpack](https://webpack.js.org/guides/getting-started/)

