WebStorm 2025.2 Help

Flow

Flow 是一款静态类型检查工具,可为 JavaScript 提供类型注解功能。 WebStorm 能够识别 Flow 结构并在所有操作系统中为其提供语法高亮显示。

开始之前

请确保您的计算机上已安装 Node.js

安装并配置 Flow

  • 在嵌套的 终端Alt+F12 )中,使用以下命令之一:

    • 要全局安装 Flow,请运行:

      npm install --global flow-bin
    • 要将 Flow 安装为开发依赖项,请运行:

      npm install --save-dev flow-bin

请访问 Flow 官方网站 了解更多信息。

若要让 WebStorm 识别 Flow 结构、提供正确的语法高亮、准确报告错误并避免误报错误高亮,需将项目中的 JavaScript 语言级别更改为 Flow 、向项目中添加一个 .flowconfig 配置文件,并确保被检查的每个文件顶部都添加一个 // @flow 注释。

将项目语言级别更改为 Flow

  1. 在对话框 设置Ctrl+Alt+S )中,转到 语言与框架 | JavaScript。 将打开 JavaScript 页面。

  2. JavaScript 语言版本 列表中,选择 Flow

  3. Flow 包或可执行文件 字段中,指定 node_modules\flow-bin 包或 Flow 可执行文件的路径。 要使用 node_modules\.bin\flow ,请确保已将 Node.js 的路径添加到 PATH 环境变量。

  4. 使用 Flow 服务器进行: 区域中,选择或取消以下复选框,以指定代码辅助的基础:

    • 类型检查: 选中此复选框后,将根据从 Flow 服务器收到的数据提供语法和错误高亮显示。 取消选中此复选框后,仅提供 WebStorm 的基本内部高亮显示。

    • 导航、代码补全与类型提示: 选中此复选框后,引用解析和代码补全建议列表中将同时包含从 Flow 集成中获取的建议和 WebStorm 计算的建议。 取消选中后,引用仅通过 WebStorm 的计算进行解析。

    仅在指定了 Flow 可执行文件的路径后,复选框才可用。

  5. 保持选中 自动保存所有已修改文件 复选框,以确保 Flow 持续生效,因为 Flow 仅在所有其他已修改文件保存后才检查当前文件。

启用 Flow

  1. 要添加 .flowconfig ,请打开嵌套的 终端Alt+F12 ),然后输入:

    flow init

    要将 .flowconfig 添加到指定文件夹,请输入:

    cd <path to the folder to check>

    flow init

  2. 要在文件中启用 Flow,请在文件顶部添加 // @flow 注释:只需输入 flow ,按下 Tab ,WebStorm 会将其扩展为 // @flow

    如果尚未拥有 .flowconfig ,WebStorm 会显示提示,建议您向当前文件夹添加配置文件。

    工具提示:将 .flowconfig 添加到当前文件夹

    要在当前文件夹和项目根目录之间进行选择,请点击 更多操作 或按下 Alt+Enter

    工具提示:更多操作

监视错误

WebStorm 允许您在 问题 工具窗口中查看由 Flow 检测到的错误。 要打开该工具窗口,可从主菜单中选择 视图 | 工具窗口 | 问题 ,或点击编辑器右下角的小部件。

检查小部件

该工具窗口由两个面板组成。

  • 错误 面板显示活动编辑器标签页中已打开文件中检测到的所有差异列表。 顶部显示文件的完整路径。

    错误面板

    要查看更多关于某个错误的信息,请在其描述的上下文菜单中选择 显示错误详细信息

    错误面板:显示详细信息
  • 项目错误 面板显示当前项目中所有文件中检测到的差异列表。 错误信息按检测到它们的文件进行分组。

    项目错误面板

请参阅 运行检查获取结果并修复问题 了解更多信息。

最后修改日期: 2025年 9月 26日