# JavaScript

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

> **TL;DR**
> 必需插件  :
>
>
>
> `JavaScript 和 TypeScript`  -  插件与 CLion 捆绑在一起，并默认启用。

借助 CLion，您可以使用  JavaScript  开发现代 web、移动和桌面应用程序。

JavaScript 感知的编码辅助包括关键字、标签、变量、参数和函数的 [代码补全](auto-completing-code.html)， [错误和语法高亮](#ws_js_syntax_highlighting)、格式化、 [代码检查](code-inspection.html)和 [快速修复](null)，以及 [常见和 JavaScript 特定的重构](specific-javascript-refactorings.html)。 CLion 还集成了 [JavaScript linters](linters.html) 和 [Flow type checker](null)。

借助内置调试器，您可以调试客户端和服务器端代码，甚至可以在 [交互调试控制台](interactive-debugger-console.html)中运行 JavaScript 代码段。 请注意，CLion 仅支持在  Chrome  或  Chrome  系列的其他浏览器中调试 JavaScript。 了解更多 [在 Chrome 中调试 JavaScript](debugging-javascript-in-chrome.html)。

CLion 与 [Jest](running-unit-tests-on-jest.html)、 [Karma](running-unit-tests-on-karma.html)、 [Protractor](protractor.html)、 [Cucumber](null) 和 [Mocha](running-unit-tests-on-mocha.html) 测试框架集成。 CLion 支持运行和调试测试，并支持在测试和受测对象之间或失败的测试与导致问题的代码片段之间进行导航。

在此页面上，您将找到一个简短的入门指南，它将一步步引导您从创建 Web 应用程序到调试和测试。

## 在开始之前

请确保在设置中启用  JavaScript 和 TypeScript  插件。 按 `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 和 TypeScript 。 有关插件的更多信息，请参阅 [管理插件](managing-plugins.html)。

## 创建一个新应用程序

CLion 可以创建一个基本的 JavaScript 项目，您可以通过最少的配置来设置项目。 生成的项目包括一个  `package.json`  和一个  `index.js`  文件，内含  `console.log()`  欢迎信息，您还可以另外生成一个示例 Web 应用程序。

默认情况下，CLion会自动创建一个 Git 仓库，并 [将生成的源文件置于 Git 控制之下](set-up-a-git-repository.html#put-existing-project-under-Git)。

Procedure:

1. 点击   新项目   屏幕上的   欢迎   或从主菜单中选择  `文件 | 新建 项目` 。 “ [新建 项目 对话框](null)”打开。

2. 在左侧窗格中，选择以下选项之一：

* Web Starter Kit

* Bootstrap

* HTML 5 Boilerplate

* Foundation

* React

* React Native

要查看 Angular、Node.js、Vue.js 的项目选项，请安装并启用相应的插件。

> **Tip:**
> 或者，选择   空项目   并手动完成所有设置。

3. 在右侧窗格中，选择   JavaScript  并指定存储项目相关文件的文件夹路径，以及项目模板的版本。

4. 要生成一个示例 Web 应用程序，请选中   生成一个带有入门提示的演练项目   复选框。 CLion 将基于 [Vite](https://vitejs.dev/) 模板创建一个项目，并提供提示以确保顺利上手。

5. 点击   创建  。

## 从现有的 JavaScript 应用程序开始

如果您打算继续开发一个现有的 JavaScript 应用程序，请在 CLion 中打开它， [选择要使用的 JavaScript 版本](#ws_js_choose_language_version)，并配置其中的库。 可选地 [下载所需的 npm 依赖项](#ws_js_download_npm_dependencies)。

Procedure: 打开您机器上已有的应用程序源代码

* 点击   打开   屏幕上的   欢迎   或从主菜单中选择  `文件 | 打开` 。 在打开的对话框中，选择存储源文件的文件夹。

Procedure: 从您的版本控制中检出应用程序源代码

1. 在   欢迎   屏幕上单击   克隆存储库  。

或者，从主菜单中选择  `文件 | 新建 | 从版本控制创建项目…`  或  `Git | 克隆…`  或  `VCS | 从版本控制获取` 。

您可能会看到与您的项目相关联的其他版本控制系统，而不是在主菜单中的   Git  。 例如，   Mercurial   或   Perforce  。

2. 在打开的对话框中，从列表中选择您的版本控制系统，并指定要从中检出的应用程序源代码的存储库。 如需了解更多信息，请参见 [Check out a project (clone)](manage-projects-hosted-on-github.html#clone-from-GitHub)。

### 项目安全性

当您打开一个在 CLion 之外创建并导入到 CLion 的项目时，CLion 会显示一个对话框，您可以在其中决定如何处理这个具有不熟悉源代码的项目。

请选择以下选项之一：

* 安全模式中预览 ：在这种情况下，CLion 以预览模式打开项目。 这意味着您可以浏览项目的源代码，但不能运行任务和脚本或运行/调试您的项目。 CLion 会在编辑器区域顶部显示一条通知，您可以随时点击 信任项目… 链接并加载您的项目。

* 信任项目 ：在这种情况下，CLion 会打开并加载一个项目。 这意味着项目已经初始化，项目的插件已解析，依赖项已添加，并且所有 CLion 功能都可用。

* 请勿打开 ：在这种情况下，CLion 不会打开项目。

请从 [项目安全性](project-security.html) 了解更多。

> **Tip:**
> 从欢迎屏幕或通过  `文件 | 新建 | 项目`  创建的项目（如描述中所述）会自动被视为受信任。

## 选择 JavaScript 语言版本

要获得可靠高效的编码支持，您需要指定将在项目的所有 JavaScript 文件中默认使用的语言版本。

Procedure:

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` 。 [JavaScript 页面](settings-languages-javascript.html)打开。

2. 从列表中选择支持的 JavaScript 语言版本之一：

* [ECMAScript 5.1](http://www.ecma-international.org/ecma-262/5.1/)

* [ECMAScript 6+](http://www.ecma-international.org/ecma-262/6.0/)：此版本增加了对 ECMAScript 2015-2020 引入的功能的支持，以及对 JSX 语法和一些当前标准提案的支持。

* [Flow](https://flow.org/)：此版本增加了对 Flow 语法的支持。

### 使用多个 JavaScript 版本

如果您正在开发一个同时使用 ECMAScript 5.1 和更新版本 ECMAScript 的应用程序，最简单的方法是从 [JavaScript 页面](settings-languages-javascript.html)（  `设置 | 语言与框架 | JavaScript` ）的列表中为整个项目选择最高的语言版本。

Procedure:

1. 在 [JavaScript 页面](settings-languages-javascript.html)，点击 ![“浏览”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)旁边的   JavaScript 语言版本},{  列表。   JavaScript 语言版本  对话框打开。

2. 点击 ![Add](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，在打开的对话框中选择 您 需要自定义语言版本的文件夹。 CLion 将您带回显示所选文件夹的   JavaScript 语言版本   对话框，在   路径   字段中显示。

3. 从   语言  列表中选择所选文件夹中的文件的语言版本。 在项目中的所有其他 JavaScript 文件中，CLion 将使用在 [JavaScript 页面](settings-languages-javascript.html)上选择的版本。

![选择单独文件夹的语言版本](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_choose_language_version.png)

### JavaScript 代码中的 JSX 语法

如果您在 JavaScript 代码中使用 JSX 语法，请启用   ECMAScript 6+  。

Procedure:

* 在   设置  对话框（ `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` ，并从   JavaScript 语言版本},{  列表中选择   ECMAScript 6+  。

* 要在误用 JSX 语法时收到警告，请打开   设置   对话框 ( `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 与 TypeScript | 常规   节点下启用   使用 JSX 语法   检查。 使用搜索字段定位检查。

![启用 React JSX 语法检查](https://resources.jetbrains.com/help/img/idea/2026.3/ws_choose_language_version_jsx.png)

您可以选择配置检查的严重性和作用域。 了解更多 [代码检查](code-inspection.html)。

## 下载项目依赖项

如果您的应用程序使用了一些工具、库或框架，请下载所需的包。 要管理您的项目依赖项，您可以使用 [npm](https://docs.npmjs.com/)、 [Yarn 1](https://classic.yarnpkg.com/lang/en/) 或 [Yarn 2](https://yarnpkg.com/)，详情请参阅 [npm and Yarn](installing-and-removing-external-software-using-node-package-manager.html)。

Procedure: 在空项目中安装包

* 在命令行 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 <package name>` .

Procedure: 如果您的项目中已经有一个 package.json 文件

* 在编辑器中或   项目   工具窗口（ `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))）中，右键单击  `package.json`  文件，并从上下文菜单中选择   运行 'npm install'  。

* 或者， 在  `npm install`  中运行   终端   `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))。

> **Note:**
> 在开始之前，请确保您的电脑上安装了 [Node.js](http://nodejs.org/)。

## 配置项目依赖的代码补全

为了为项目依赖项提供代码补全功能，CLion 会自动创建一个  node_modules 库。 在语言和集成开发环境（IDE）的上下文中，  library  是一个文件或一组文件。 除了 CLion 从您编辑的项目代码中获取的函数和方法外，这些文件的函数和方法也会添加到 CLion 的内部知识中。 如需更多信息，请参阅 [配置 JavaScript 库](configuring-javascript-libraries.html)和 [代码补全](auto-completing-code.html)。

## 查看内嵌提示

内嵌提示出现在编辑器中，为您的代码提供额外信息，使其更易于阅读和导航。

### 参数提示

参数提示  显示方法和函数中的参数名称，以使您的代码更易读。 默认情况下，参数提示仅针对文字值或函数表达式显示，不针对命名对象显示。

![JavaScript 中的参数提示](https://resources.jetbrains.com/help/img/idea/2026.3/ws_javascript_parameter_hints.png)

Procedure: 配置参数提示

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))），然后转到  `编辑器 | 内联提示` 。

2. 展开   JavaScript  下的   参数名称  。

3. 通过选择相应的复选框指定您希望显示参数提示的上下文。

预览显示了您在设置中所做的更改如何影响代码外观。

4. 对于某些方法和函数，CLion 在任何情况下都不会显示参数提示。 请点击   排除列表...  查看这些方法和函数，可能启用参数提示，或者向列表中添加新项目。

5. 要隐藏任意上下文中任意值类型的参数提示，请取消选中   JavaScript   复选框下的   参数名称  。

### 返回类型提示

CLion 能在函数调用和调用链中显示函数返回类型。

* 函数返回类型提示 是从 [JSDoc 注释](creating-jsdoc-comments.html) 或基于代码的静态分析推断出来的。

* 方法链接中的返回类型提示 将在方法调用分割为多行并返回至少 2 种不同类型时显示。 方法链中的返回类型提示由内部 CLion 评估器提供。

Procedure: 配置方法返回类型提示

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))），然后转到  `编辑器 | 内联提示` 。

2. 在   类型   下，展开   JavaScript   节点，然后选中   函数返回类型   复选框。

3. 若要在方法链中显示返回类型提示，请展开   方法链  节点并选中   JavaScript  复选框。

预览显示了您在设置中所做的更改如何影响代码外观。

### 类型提示

类型提示  显示变量、字段或参数的类型。 变量和字段的类型显示在其定义旁边。 参数的类型提示显示在函数调用中。 类型提示是从 [JSDoc comments](creating-jsdoc-comments.html) 或您的代码的静态分析中推断出的。

![JavaScript 中的类型注解](https://resources.jetbrains.com/help/img/idea/2026.3/ws_type_hints_annotations.png)

Procedure: 配置类型提示

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))），然后转到  `编辑器 | 内联提示` 。

2. 在类别树中展现  `类型 | JavaScript` 。

3. 指定您希望显示类型提示的上下文。

预览显示了您在设置中所做的更改如何影响代码外观。

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/ws_type_annotations_javascript.mp4)

4. 若要隐藏在任何上下文中任何值类型的参数类型提示和返回类型提示，请取消选中   JavaScript   复选框   类型  。

## 添加导入语句

CLion 可以生成模块、类、组件以及任何其他导出的符号的导入语句。 导入语句可以在补全符号时即时添加，也可以通过导入工具提示或使用快速修复或意图操作在之后添加。

CLion 可以生成 [ES6](#ws_js_auto_import_es6_module) 或 [CommonJS](#ws_js_auto_import_common_js) 风格的导入语句。 CLion 可自行决定导入语句的风格，或弹出窗口让您选择所需的风格。

如果 CLion 无法自动确定文件中应使用哪种语法，它会显示一个弹出窗口，供您选择使用 ES6 还是 CommonJS 语法。

![快速修复：选择导入样式](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_auto_import_select_style_popup.png)

要始终在代码补全时自动添加 ES6 导入语句，请打开   设置   对话框（ `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))），转到  `编辑器丨常规丨自动导入` ，并在   TypeScript/JavaScript   区域中勾选   自动添加 JavaScript 导入   复选框。

### 添加 ES6 import 语句

导入语句可以在补全符号时即时添加，也可以通过导入工具提示或使用快速修复或意图操作在之后添加。

自动导入补全时:

Procedure:

如果您从项目中导入符号到一个 ES6 模块文件或已经包含 ES 导入语句的文件中，CLion 会在符号补全时自动插入 ES6 导入。

![在代码补全时添加 ES6 导入](https://resources.jetbrains.com/help/img/idea/2026.3/ws_es6_auto-import.animated.gif)

使用自动导入工具提示:

Procedure:

当您将鼠标悬停在未解析符号上时，自动导入工具提示会出现，并建议添加导入语句。

* 要接受建议，请按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS))。

![通过自动导入工具提示添加 ES6 导入](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_auto_import_es6_module_tooltip.png)

* 要禁用工具提示，请将鼠标悬停在编辑器右上角的检查部件上，点击 ![更多](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.more.svg)，并取消   显示自动导入工具提示   选项。

![禁用自动导入工具提示](https://resources.jetbrains.com/help/img/idea/2026.3/ws_disable_import_pop_up.png)

使用快速修复或意图操作:

Procedure:

对于较早的 JavaScript 版本或在某些情况下，CLion 会将符号标记为未解析，并显示一个含有错误描述和建议快速修复的弹出窗口：

* 接受该建议。

![使用快速修复的自动导入：信息提示](https://resources.jetbrains.com/help/img/idea/2026.3/ws_es6_autoimport_off_tooltip.png)

* 或者，按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS))：

![自动导入快速修复：建议列表](https://resources.jetbrains.com/help/img/idea/2026.3/ws_es6_autoimport_off.png)

* 如果有多个可能的导入来源，CLion 将显示建议列表：

![快速修复的自动导入：多种选择](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_import_quick_fix_multiple_choices.png)

CLion 还可以为项目依赖项中定义的符号生成 import 语句。 自动导入功能适用于包含 [TypeScript 定义文件](https://github.com/Microsoft/TypeScript/tree/master/lib)的软件包中的符号（如 [moment](https://www.npmjs.com/package/moment)或 [redux](https://www.npmjs.com/package/redux)）或作为 ES 模块编写的源代码。

如果当前文件已经包含一个 ES6 import 语句，CLion 插入一个新的也是 ES6 风格的。

![从项目依赖项自动导入](https://resources.jetbrains.com/help/img/idea/2026.3/ws_auto_import_from_node_modules.animated.gif)

### 添加 CommonJS（require）导入语句

如果您在将符号从项目导入到已经是 CommonJS 模块（具有  `require` 语句或  `module.export` ）的文件中，CLion会在符号完成时自动插入一个 CommonJS 导入。

![使用 CommonJS import 语句自动导入](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_auto_import_common_js.animated.gif)

或者，将文本光标放置在要导入的符号处，按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS))，并选择一种使用 CommonJS（  `require` ）导入样式的快速修复。

![快速修复：选择导入样式](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_auto_import_quick_fix_select_import_style.png)

### 添加 import defer 语句

CLion 在 JavaScript 环境中支持 [import defer](https://github.com/tc39/proposal-defer-import-eval/) 语法，提供代码补全、错误高亮、  `import`  语句的实时模板以及用法搜索功能。

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_import_defer.mp4)

也支持  `import.defer`  语法：

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_await_import_defer.mp4)

> **Note:**
> `import defer`  语法不支持具名导入、默认导入，以及  `type`  和  `defer`  的组合方式。

### 添加 import source 语句

CLion 在 JavaScript 环境中支持 [import source](https://github.com/tc39/proposal-source-phase-imports) 语法，提供代码补全、错误高亮、  `import`  语句的实时模板以及用法搜索功能。

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_import_source.mp4)

也支持  `import.source`  语法：

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_await_import_source.mp4)

> **Note:**
> * `import source` 语法不支持具名导入、命名空间导入，以及 `type` 和 `source` 的组合方式。
>
> * 要在 babel 中使用 `import source` 语法，请安装 [@babel/plugin-syntax-import-source 插件](https://babeljs.io/docs/babel-plugin-syntax-import-source)。

### 配置自动导入

Procedure:

1. 要始终在代码补全时自动添加 ES6 导入语句，请打开   设置   对话框（ `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))），转到  `编辑器丨常规丨自动导入` ，并在   TypeScript/JavaScript   区域中勾选   自动添加 JavaScript 导入   复选框。

2. 要配置  `import`  语句的外观，请打开   设置   对话框（ `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` ，并使用   导入   选项卡中的控件。 有关详细信息，请参阅 [Imports 选项卡](settings-code-style-javascript.html#ws_js_settings_editor_code_style_imports_tab)。

## 配置语法高亮

您可以根据您的偏好和习惯配置 JavaScript 语法高亮显示。

Procedure:

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))) 中，前往  `Editor | Color Scheme | JavaScript` 。

2. 选择颜色方案，接受从默认设置继承的高亮设置，或按照 [颜色和字体](configuring-colors-and-fonts.html) 中的描述自定义它们。

## 重新设置代码格式

CLion 允许您根据当前的 [代码样式方案](configuring-code-style.html#configure-code-style-schemes)重新格式化 JavaScript 代码。

您还可以在 [.editorconfig](null) 中指定格式设置，或使用 [Prettier](prettier.html)。

### 装饰器

对于装饰器，在重新格式化期间抑制在每个装饰器后插入换行可能很重要。

以下是装饰器的可用格式设置选项：

#### 请勿换行

选中此选项时，重新格式化带装饰器的行时不会自动换行。

类装饰器:

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_reformat_class_decorator_do_not_wrap.mp4)

方法装饰器:

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_reformat_code_decorators_do_not_wrap_class_method_decorators.mp4)

字段装饰器:

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_reformat_code_decorators_do_not_wrap_class_field_decorators.mp4)

函数参数装饰器:

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_reformat_code_decorators_do_not_wrap_function_parameter_decorators.mp4)

#### 如果太长则进行换行

选择此选项时，如果行超出右边距，则会换行。

右边距在   在以下位置硬包装   字段中定义，位于 [设置 | 编辑器 | 代码样式 | JavaScript | 换行和大括号](settings-code-style-javascript.html#ws_js_settings_editor_code_style_wrapping_and_braces_tab) 中。 如果行超出指定的数字，则会换行。

类装饰器:

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_reformat_class_decorator_wrap_if_long.mp4)

方法装饰器:

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_reformat_code_decorators_wrap_if_long_class_method_decorators.mp4)

字段装饰器:

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_reformat_code_decorators_wrap_if_long_class_field_decorators.mp4)

函数参数装饰器:

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_reformat_code_decorators_wrap_if_long_function_parameter_decorators.mp4)

#### 如果太长就砍掉

选择此选项时，如果装饰器超出右边距，将每行格式化一个装饰器。

#### 始终换行

选择此选项时，所有装饰器将每行格式化一个。

类装饰器:

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_reformat_class_decorator_wrap_always.mp4)

方法装饰器:

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_reformat_code_decorators_wrap_always_class_method_decorators.mp4)

字段装饰器:

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_reformat_code_decorators_wrap_always_class_field_decorators.mp4)

函数参数装饰器:

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_reformat_code_decorators_wrap_always_function_parameter_decorators.mp4)

## 在浏览器中运行 JavaScript

Procedure:

1. 在编辑器中，打开带有 JavaScript 引用的 HTML 文件。 此 HTML 文件不一定是实现应用程序起始页的文件。

2. 请执行以下操作之一：

* 从主菜单中选择 `查看 | 在浏览器中打开` 或按 `Alt+F2` (Windows), `⌥ F2` (macOS), `⌥ F2` (IntelliJ IDEA Classic (macOS)), `⌥ F2` (macOS System Shortcuts), `Alt+F2` (XWin), `Alt+F2` (GNOME), `Alt+F2` (KDE), `Alt+F2` (Emacs), `Alt+F2` (Sublime Text), `Alt+F2` (Sublime Text (macOS)), `⌥ F2` (Xcode), `Alt+F2` (Visual Studio), `⌥ F2` (Visual Studio (macOS)), `Alt+F2` (ReSharper), `⌥ F2` (ReSharper (macOS)), `Alt+F2` (QtCreator), `⌥ F2` (QtCreator (macOS)), `Alt+F2` (NetBeans), `Alt+F2` (Eclipse), `⌥ F2` (Eclipse (macOS))。 然后从列表中选择所需的浏览器。

* 将鼠标悬停在代码上以显示浏览器图标栏： ![CLion 图标](https://resources.jetbrains.com/help/img/idea/2026.3/product.artwork.clion.svg) ![Chrome](https://resources.jetbrains.com/help/img/idea/2026.3/app.xml.browsers.chrome.svg) ![Firefox](https://resources.jetbrains.com/help/img/idea/2026.3/app.xml.browsers.firefox.svg) ![Safari](https://resources.jetbrains.com/help/img/idea/2026.3/app.xml.browsers.safari.svg) ![Opera](https://resources.jetbrains.com/help/img/idea/2026.3/app.xml.browsers.opera.svg) ![Internet Explorer](https://resources.jetbrains.com/help/img/idea/2026.3/app.xml.browsers.explorer.svg) ![Edge](https://resources.jetbrains.com/help/img/idea/2026.3/app.xml.browsers.edge.svg)。 点击指示所需浏览器的图标。

## 调试 JavaScript

CLion 提供了一个内置调试器，用于调试您的客户端 JavaScript 代码，兼容  Chrome 或其他  Chrome 系列浏览器。 使用 CLion，您可以调试在内置服务器、外部服务器或远程服务器上运行的 JavaScript 应用程序。 如需了解更多信息，请参阅 [在 Chrome 中调试 JavaScript](debugging-javascript-in-chrome.html)。

