在 VS Code 中试用

Visual Studio Code 中的 JavaScript

Visual Studio Code 内置了 JavaScript 智能感知、调试、格式化、代码导航、重构以及许多其他高级语言功能。

Working with JavaScript in Visual Studio Code

其中大多数功能开箱即用,而有些可能需要进行基本配置才能获得最佳体验。本页总结了 VS Code 附带的 JavaScript 功能。VS Code 市场中的扩展可以增强或更改大多数这些内置功能。有关这些功能如何工作以及如何配置的更深入指南,请参阅使用 JavaScript

智能感知

智能感知向您显示智能代码补全、悬停信息和签名信息,以便您可以更快、更正确地编写代码。

VS Code 在您的 JavaScript 项目中提供智能感知;适用于许多 npm 库,例如 Reactlodashexpress;以及适用于其他平台,例如 node、无服务器或 IoT。

有关 VS Code 的 JavaScript 智能感知、如何配置它以及帮助解决常见智能感知问题的信息,请参阅使用 JavaScript

JavaScript 项目 (jsconfig.json)

一个 jsconfig.json 文件定义了 VS Code 中的 JavaScript 项目。虽然不强制要求使用 jsconfig.json 文件,但在以下情况下您会希望创建一个:

  • 如果您的工作区中并非所有 JavaScript 文件都应被视为单个 JavaScript 项目的一部分。jsconfig.json 文件允许您将某些文件从智能感知中排除。
  • 确保您的工作区中的一部分 JavaScript 文件被视为一个项目。如果您正在处理使用隐式全局依赖项而不是 imports 来管理依赖项的旧代码,这将非常有用。
  • 如果您的工作区包含多个项目上下文,例如前端和后端 JavaScript 代码。对于多项目工作区,请在每个项目的根文件夹中创建一个 jsconfig.json
  • 您正在使用 TypeScript 编译器将 JavaScript 源代码降级编译。

要定义一个基本的 JavaScript 项目,请在工作区的根目录下添加一个 jsconfig.json

{
  "compilerOptions": {
    "module": "CommonJS",
    "target": "ES6"
  },
  "exclude": ["node_modules"]
}

有关更高级的 jsconfig.json 配置,请参阅使用 JavaScript

提示

要检查 JavaScript 文件是否是 JavaScript 项目的一部分,只需在 VS Code 中打开该文件并运行JavaScript: 转到项目配置命令。此命令会打开引用该 JavaScript 文件的 jsconfig.json。如果该文件不属于任何 jsconfig.json 项目,则会显示通知。

代码片段

VS Code 包含基本的 JavaScript 代码片段,这些代码片段会在您键入时被建议;

有许多扩展提供了额外的代码片段,包括适用于流行框架(如 Redux 或 Angular)的代码片段。您甚至可以定义自己的代码片段

提示

要禁用代码片段建议,请在您的设置文件中将 editor.snippetSuggestions 设置为 "none"editor.snippetSuggestions 设置还允许您更改代码片段在建议中的显示位置:顶部 ("top")、底部 ("bottom") 或按字母顺序内联排列 ("inline")。默认值为 "inline"

JSDoc 支持

VS Code 理解许多标准 JSDoc 注释,并使用这些注释来提供丰富的智能感知。您甚至可以选择使用 JSDoc 注释中的类型信息来类型检查您的 JavaScript

通过在函数声明前键入 /** 并选择JSDoc 注释代码片段建议,可以快速为函数创建 JSDoc 注释

要禁用 JSDoc 注释建议,请设置 "javascript.suggest.completeJSDocs": false

悬停信息

将鼠标悬停在 JavaScript 符号上,可快速查看其类型信息和相关文档。

Hovering over a JavaScript variable to see its type information

键盘快捷方式 ⌘K ⌘I (Windows, Linux Ctrl+K Ctrl+I) 可在当前光标位置显示此悬停信息。

签名帮助

当您编写 JavaScript 函数调用时,VS Code 会显示函数签名信息并突出显示您当前正在补全的参数

Signature help for some DOM methods

当您在函数调用中键入 (, 时,会自动显示签名帮助。按下 ⇧⌘Space (Windows, Linux Ctrl+Shift+Space) 可手动触发签名帮助。

自动导入

自动导入通过在整个项目及其依赖项中建议可用变量来加快编码速度。当您选择其中一个建议时,VS Code 会自动在文件顶部添加其导入语句。

只需开始键入即可查看当前项目中所有可用 JavaScript 符号的建议。自动导入建议会显示它们的导入来源

Global symbols are shown in the suggestion list

如果您选择其中一个自动导入建议,VS Code 会为其添加导入语句。

在此示例中,VS Code 在文件顶部添加了从 material-ui 导入 Button 的语句

After selecting a symbol from a different file, an import is added for it automatically

要禁用自动导入,请将 "javascript.suggest.autoImports" 设置为 false

提示

VS Code 尝试推断要使用的最佳导入样式。您可以使用 javascript.preferences.quoteStylejavascript.preferences.importModuleSpecifier 设置明确配置添加到代码中的导入的首选引用样式和路径样式。

粘贴时添加导入

当您在编辑器之间复制和粘贴代码时,VS Code 可以在粘贴代码时自动添加导入。当您粘贴包含未定义符号的代码时,会显示一个粘贴控件,允许您选择是粘贴为纯文本还是添加导入。

此功能默认启用,但您可以通过切换 javascript.updateImportsOnPaste.enabled 设置来禁用它。

您可以通过配置 editor.pasteAs.preferences 设置,使带导入的粘贴成为默认行为,而无需显示粘贴控件。包含 text.updateImports.jststext.updateImports 可始终在粘贴时添加导入。

组织导入

组织导入源操作可对 JavaScript 文件中的导入进行排序并移除任何未使用的导入

您可以从源操作上下文菜单运行组织导入,或使用键盘快捷方式 ⇧⌥O (Windows, Linux Shift+Alt+O)

您也可以通过设置,在保存 JavaScript 文件时自动组织导入

"editor.codeActionsOnSave": {
    "source.organizeImports": "explicit"
}

文件移动时更新导入

当您移动或重命名 JavaScript 项目中被其他文件导入的文件时,VS Code 可以自动更新所有引用已移动文件的导入路径

设置 javascript.updateImportsOnFileMove.enabled 控制此行为。有效的设置值为

  • "prompt" - 默认值。针对每次文件移动询问是否应更新路径。
  • "always" - 始终自动更新路径。
  • "never" - 不自动更新路径,也不提示。

格式化

VS Code 内置的 JavaScript 格式化程序提供了具有合理默认值的基本代码格式化功能。

javascript.format.* 设置可配置内置格式化程序。或者,如果内置格式化程序阻碍了您的工作,请将 "javascript.format.enable" 设置为 false 以禁用它。

对于更专业的代码格式化样式,请尝试从 市场安装一个 JavaScript 格式化扩展。

JSX 和自动关闭标签

VS Code 的所有 JavaScript 功能也适用于 JSX

JSX IntelliSense

您可以在普通 *.js 文件和 *.jsx 文件中使用 JSX 语法。

VS Code 还包括 JSX 特有的功能,例如 JSX 标签的自动关闭

"javascript.autoClosingTags" 设置为 false 可禁用 JSX 标签关闭。

代码导航

代码导航允许您快速导航 JavaScript 项目。

  • 转到定义 F12 - 转到符号定义的源代码。
  • 查看定义 ⌥F12 (Windows Alt+F12, Linux Ctrl+Shift+F10) - 调出一个查看窗口,显示符号的定义。
  • 转到引用 ⇧F12 (Windows, Linux Shift+F12) - 显示符号的所有引用。
  • 转到类型定义 - 转到定义符号的类型。对于类的实例,这将显示类本身,而不是实例的定义位置。

您可以使用命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中的转到符号命令通过符号搜索进行导航。

  • 文件中的符号 ⇧⌘O (Windows, Linux Ctrl+Shift+O)
  • 工作区中的符号 ⌘T (Windows, Linux Ctrl+T)

重命名

F2 可在您的 JavaScript 项目中重命名光标下的符号

Renaming a variable

重构

VS Code 包含一些方便的 JavaScript 重构,例如提取函数提取常量。只需选择您要提取的源代码,然后单击边栏中的灯泡图标或按下 (⌘. (Windows, Linux Ctrl+.)) 即可查看可用的重构。

JavaScript refactoring

可用的重构包括

  • 提取到方法或函数。
  • 提取到常量。
  • 在命名导入和命名空间导入之间转换。
  • 移动到新文件。

有关重构以及如何为单个重构配置键盘快捷方式的更多信息,请参阅重构

此外,代码操作小组件:包含附近快速修复 (editor.codeActionWidget.includeNearbyQuickFixes) 是一个默认启用的设置,无论您的光标在该行的何处,它都将从 ⌘. (Windows, Linux Ctrl+.) (命令 ID editor.action.quickFix) 激活行中最接近的快速修复。

该命令会突出显示将通过快速修复进行重构或修复的源代码。普通代码操作和非修复重构仍可在光标位置激活。

未使用的变量和不可达代码

未使用的 JavaScript 代码,例如始终为 true 的 if 语句的 else 块或未引用的导入,在编辑器中会淡出显示

Unreachable source code faded out

您可以通过将光标放在其上并触发快速修复命令 (⌘. (Windows, Linux Ctrl+.)) 或单击灯泡图标来快速移除此未使用的代码。

要禁用未使用的代码的淡出显示,请将 "editor.showUnused" 设置为 false。您还可以通过设置仅在 JavaScript 中禁用未使用的代码的淡出显示

"[javascript]": {
    "editor.showUnused":  false
},
"[javascriptreact]": {
    "editor.showUnused":  false
},

保存时代码操作

通过 editor.codeActionsOnSave 设置,您可以配置在保存文件时运行的一组代码操作。例如,您可以通过设置来启用保存时组织导入

// On explicit save, run fixAll source action. On auto save (window or focus change), run organizeImports source action.
"editor.codeActionsOnSave": {
    "source.fixAll": "explicit",
    "source.organizeImports": "always",
}

截至目前,支持以下枚举

  • explicit (默认值):在显式保存时触发代码操作。与 true 相同。
  • always:在显式保存和窗口或焦点更改自动保存时触发代码操作。
  • never:从不触发保存时代码操作。与 false 相同。

您还可以将 editor.codeActionsOnSave 设置为按顺序执行的代码操作数组。

以下是一些源操作

  • "organizeImports" - 启用保存时组织导入。
  • "fixAll" - 保存时自动修复会一次性计算所有可能的修复(包括 ESLint 在内的所有提供程序)。
  • "fixAll.eslint" - 仅对 ESLint 进行自动修复。
  • "addMissingImports" - 保存时添加所有缺失的导入。

有关更多信息,请参阅Node.js/JavaScript

代码建议

VS Code 会自动建议一些常见的代码简化,例如将 promise 上的 .then 调用链转换为使用 asyncawait

"javascript.suggestionActions.enabled" 设置为 false 可禁用建议。

使用 AI 增强补全

GitHub Copilot 是一款由 AI 提供支持的代码补全工具,可帮助您更快、更智能地编写代码。您可以在 VS Code 中使用 GitHub Copilot 扩展来生成代码,或从其生成的代码中学习。

GitHub Copilot extension in the VS Code Marketplace

GitHub Copilot 为多种语言和各种框架提供建议,它特别适用于 Python、JavaScript、TypeScript、Ruby、Go、C# 和 C++。

您可以在Copilot 文档中了解更多关于如何开始使用 Copilot 的信息。

安装并启用 Copilot 扩展后,您可以在 JavaScript 项目中测试它。

创建新文件 - 您可以使用命令面板中的文件: 新建文件命令 (F1)。

在 JavaScript 文件中,键入以下函数头

function calculateDaysBetweenDates(begin, end) {

Copilot 将提供如下建议 - 使用 Tab 键接受建议

Copilot JavaScript ghost text suggestion

嵌入式提示

嵌入式提示向源代码添加额外的内联信息,以帮助您理解代码的作用。

参数名嵌入式提示显示函数调用中参数的名称

Parameter name inlay hints

这有助于您一目了然地理解每个参数的含义,这对于接受布尔标志或参数容易混淆的函数特别有用。

要启用参数名提示,请设置 javascript.inlayHints.parameterNames。有三个可能的值

  • none — 禁用参数嵌入式提示。
  • literals — 仅显示文字(字符串、数字、布尔值)的嵌入式提示。
  • all — 显示所有参数的嵌入式提示。

变量类型嵌入式提示显示没有显式类型注解的变量的类型。

设置:javascript.inlayHints.variableTypes.enabled

Variable type inlay hints

属性类型嵌入式提示显示没有显式类型注解的类属性的类型。

设置:javascript.inlayHints.propertyDeclarationTypes.enabled

Property type inlay hints

参数类型提示显示隐式类型参数的类型。

设置:javascript.inlayHints.parameterTypes.enabled

Parameter type inlay hints

返回类型嵌入式提示显示没有显式类型注解的函数的返回类型。

设置:javascript.inlayHints.functionLikeReturnTypes.enabled

Return type inlay hints

引用 CodeLens

JavaScript 引用 CodeLens 会为类、方法、属性和导出对象显示内联引用计数

JavaScript references CodeLens

要启用引用 CodeLens,请将 "javascript.referencesCodeLens.enabled" 设置为 true

单击引用计数可快速浏览引用列表

JavaScript references CodeLens peek

代码检查器

代码检查器为可疑代码提供警告。虽然 VS Code 不包含内置的 JavaScript 代码检查器,但市场上提供了许多 JavaScript 代码检查器扩展

提示

此列表是从 VS Code Marketplace 动态查询的。阅读描述和评论以决定此扩展是否适合您。

类型检查

您也可以在常规 JavaScript 文件中利用 TypeScript 的一些高级类型检查和错误报告功能。这是捕获常见编程错误的好方法。这些类型检查还为 JavaScript 启用了一些令人兴奋的快速修复,包括添加缺失导入添加缺失属性

Using type checking and Quick Fixes in a JavaScript file

TypeScript 尝试以与在 .ts 文件中相同的方式推断 .js 文件中的类型。当无法推断类型时,可以使用 JSDoc 注释显式指定。您可以在使用 JavaScript 中阅读有关 TypeScript 如何使用 JSDoc 进行 JavaScript 类型检查的更多信息。

JavaScript 的类型检查是可选的,并且需要选择启用。现有的 JavaScript 验证工具(例如 ESLint)可以与内置的类型检查功能一起使用。

调试

VS Code 对 JavaScript 提供了出色的调试支持。在调试控制台中设置断点、检查对象、导航调用堆栈以及执行代码。有关更多信息,请参阅调试主题

调试客户端

您可以使用浏览器调试器调试客户端代码,例如我们内置的 Edge 和 Chrome 调试器,或适用于 Firefox 的调试器

调试服务器端

使用内置调试器在 VS Code 中调试 Node.js。设置简单,并且有Node.js 调试教程可帮助您。

debug data inspection

VS Code 对 JavaScript 提供了出色的支持,但您还可以通过扩展安装调试器、代码片段、代码检查器以及其他 JavaScript 工具。

提示

上面显示的扩展是动态查询的。单击上面的扩展磁贴以阅读描述和评论,从而决定哪个扩展最适合您。在市场中查看更多信息。

后续步骤

继续阅读以了解

  • 使用 JavaScript - 有关 VS Code 的 JavaScript 支持以及如何解决常见问题的更详细信息。
  • jsconfig.json - jsconfig.json 项目文件的详细说明。
  • 智能感知 - 了解更多关于智能感知以及如何在您的语言中有效使用它的信息。
  • 调试 - 了解如何为您的应用程序设置调试。
  • Node.js - 创建 Express Node.js 应用程序的演练。
  • TypeScript - VS Code 对 TypeScript 提供了出色的支持,它为您的 JavaScript 代码带来了结构和强类型。

常见问题

VS Code 支持 JSX 和 React Native 吗?

VS Code 支持 JSXReact Native。您将从 npmjs 类型声明文件仓库中自动下载的类型声明 (typings) 文件获得 React/JSXReact Native 的智能感知。此外,您还可以从市场安装流行的 React Native 扩展

要为 React Native 启用 ES6 import 语句,您需要将 allowSyntheticDefaultImports 编译器选项设置为 true。这会告诉编译器创建合成默认成员,然后您就可以获得智能感知。React Native 在后台使用 Babel 来创建包含默认成员的正确运行时代码。如果您还想调试 React Native 代码,可以安装 React Native 扩展

VS Code 支持 Dart 编程语言和 Flutter 框架吗?

是的,VS Code 为 DartFlutter 开发都提供了扩展。您可以在 Flutter.dev 文档中了解更多信息。

外部库的智能感知不起作用

自动类型获取适用于 npm 下载的依赖项(在 package.json 中指定)、Bower 下载的依赖项(在 bower.json 中指定),以及您的文件夹结构中列出的许多最常用库(例如 jquery-3.1.1.min.js)。

ES6 样式导入不起作用。

当您想使用 ES6 样式导入,但某些类型声明 (typings) 文件尚未使用 ES6 样式导出时,请将 TypeScript 编译器选项 allowSyntheticDefaultImports 设置为 true。

{
  "compilerOptions": {
    "module": "CommonJS",
    "target": "ES6",
    // This is the line you want to add
    "allowSyntheticDefaultImports": true
  },
  "exclude": ["node_modules", "**/node_modules/*"]
}

我可以调试压缩/混淆的 JavaScript 吗?

是的,您可以。您可以在Node.js 调试主题中看到这在使用 JavaScript 源映射时的工作情况。

使用非 ES6 构造时如何禁用语法验证?

有些用户希望使用诸如提议的管道 (|>) 运算符之类的语法构造。然而,这些目前不受 VS Code 的 JavaScript 语言服务支持,并被标记为错误。对于仍希望使用这些未来功能的用户,我们提供了 javascript.validate.enable 设置

通过 javascript.validate.enable: false,您将禁用所有内置语法检查。如果您这样做,我们建议您使用像 ESLint 这样的代码检查器来验证您的源代码。

我可以使用其他 JavaScript 工具,例如 Flow 吗?

是的,但是 Flow 的某些语言功能(例如类型和错误检查)可能会干扰 VS Code 的内置 JavaScript 支持。要了解如何禁用 VS Code 的内置 JavaScript 支持,请参阅禁用 JavaScript 支持