WebStorm 2025.2 Help

Shell 脚本

启用 Shell scripts 插件

此功能依赖 Shell scripts 插件,默认情况下该插件在 WebStorm 中已捆绑并启用。 如果相关功能不可用,请确保未禁用该插件。

  1. Ctrl+Alt+S 打开设置,然后选择 插件

  2. 打开 已安装 标签,找到 Shell scripts 插件,然后选中插件名称旁的复选框。

WebStorm 为 Shell 脚本文件提供编码辅助功能: 代码补全 (包括本地路径)、高亮显示、 快速文档 、文本重命名重构等。

Shell 脚本中的编码辅助

它还包括一种用于 Shell 脚本的特殊 运行/调试配置 类型。

WebStorm 可集成多个外部工具以增强对 Shell 脚本的支持:

  • ShellCheck 是一种 Shell 脚本静态分析工具,可检测语法错误、语义问题、边缘情况和常见陷阱。 如果未安装,WebStorm 会提示您进行安装。

  • Shfmt 是用于 Shell 脚本的外部格式化引擎。 首次为 Shell 脚本 重排和格式化代码 Ctrl+Alt+L 时,WebStorm 会建议您安装该工具。

  • Explainshell 是一个网站,可解析任意 Shell 命令,并为每个参数提供说明文本。 可通过 意图操作 访问此功能:按 Alt+Enter 并选择 解释 shell

配置识别为 Shell 脚本的文件类型

默认情况下,WebStorm 会将以下扩展名的文件识别为 Shell 脚本: .sh .bash .zsh 。 但您可以配置 WebStorm,以将任意文件类型识别为 Shell 脚本文件(例如,如果您希望编辑 .csh 文件)。

  1. 设置 对话框(Ctrl+Alt+S )中,选择 编辑器 | 文件类型

  2. 已识别的文件类型 列表中,选择 Shell 脚本 ,并在下方的 文件名模式 列表中添加所需的模式。

  3. 点击 确定 应用更改。

运行 Shell 脚本文件

  • 在编辑 Shell 脚本文件时,点击边距中的 运行图标。 这将在内置 终端 中运行脚本。

如果希望自定义脚本的启动方式(例如指定脚本和解释器选项),也可以创建一个 Shell 脚本 运行/调试配置

为脚本文件创建配置

  1. 在主菜单中,转到 运行 | 编辑配置

  2. 点击 添加按钮 ,然后选择 Shell 脚本

  3. 执行 下,选择 脚本文件 选项。

  4. 指定脚本文件路径及启动时要传递给脚本的选项。 您还可以更改用于运行脚本的解释器及其附加选项。

  5. 点击 确定 以保存运行/调试配置。

为 Shell 命令创建配置

可为简单的任意命令创建 Shell 脚本 运行/调试配置,无需编写脚本文件。 例如,若想在启动其他配置之前自动运行该命令且不想创建单独的文件,此方式将非常实用。

  1. 在主菜单中,转到 运行 | 编辑配置

  2. 点击 添加按钮 ,然后选择 Shell 脚本

  3. 执行 下,选择 脚本文本 选项。

  4. 输入命令文本,也可以更改命令的工作目录。

  5. 点击 确定 保存运行/调试配置。

Shell 脚本运行/调试配置

如果希望在启动其他配置(例如其他脚本)前运行该命令,您可以在其他配置的 启动前 区域中选择已创建的配置。

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