WebStorm 2025.2 Help

Vagrant:使用可复现的开发环境进行开发

Vagrant 是一个用于管理虚拟机生命周期的命令行工具。

WebStorm 与 Vagrant 完全集成,使您能够配置 Vagrant 虚拟环境、控制虚拟机的行为以及在项目中执行 Vagrant 命令。

在使用 Vagrant 的过程中,您会遇到以下定义:

  • Vagrantfile :定义 Vagrant 环境的主配置文件,存储所有虚拟 box 的配置,并指示 Vagrant 如何与虚拟机交互。

  • Virtual box :包含预配置虚拟机的虚拟沙箱。 Vagrant 可与不同的虚拟 box 提供商配合使用,例如 Oracle 的 VirtualBox、VMWare 或 AWS。

  • Instance :一台虚拟机。

先决条件

  1. 请确保已在设置中启用 Vagrant 插件。 按 Ctrl+Alt+S 打开设置,然后选择 插件。 单击 已安装 选项卡。 在搜索字段中输入 Vagrant。 有关插件的更多信息,请参阅 管理插件

  2. 安装 VagrantOracle 的 VirtualBox 应用程序。

  3. 请确保您的计算机已启用虚拟化。

初始化 Vagrantfile

要开始使用 Vagrant,需要初始化 Vagrantfile

执行以下操作之一:

  • 打开嵌入式 TerminalAlt+F12 ),并运行以下命令: vagrant init

  • 在主菜单中,转到 工具| Vagrant|在项目根目录初始化 ,并在打开的窗口中选择目标根文件夹。

项目 工具窗口 Alt+1 中,切换到 项目文件 视图,并双击 Vagrantfile ,在嵌入式编辑器中打开它。

您将看到 Vagrantfile 已包含预定义的配置。 config.vm.box = "..." 行指定项目中将使用的虚拟 box。

指定虚拟 box

作为示例,我们将指定 ubuntu/trusty64 box。 它包含一个基础的 Ubuntu 虚拟机。 您可以根据需要指定其他虚拟 box。 如需查看可用虚拟 box 列表,请参阅 发现 Vagrant Boxes

执行以下操作之一:

  • 打开 Vagrantfile 并将 config.vm.box = "base" 行更改为以下内容: config.vm.box = "ubuntu/trusty64"

  • 设置 对话框(Ctrl+Alt+S )中,选择 工具| Vagrant。 在 Box 窗口中,点击 添加按钮 按钮并指定以下内容:

    • Box 名称 :ubuntu/trusty64

    • Box URL :https://app.vagrantup.com/ubuntu/boxes/trusty64

完成 Vagrantfile 初始化并指定虚拟 box 后,您即可部署并运行虚拟机。

启动实例

执行以下操作之一:

  • 打开嵌入式 TerminalAlt+F12 ),并运行以下命令: vagrant up

  • 在主菜单中,转到 工具| Vagrant| 上

通过 SSH 连接运行中的机器

启动虚拟机后,它将在后端运行。 要通过 SSH 连接运行中的机器,请执行以下操作:

  • 打开嵌入式 TerminalAlt+F12 ),并运行以下命令: vagrant ssh

用于控制实例的 Vagrant 命令

要控制实例,可使用 Vagrant 命令。 可以从 TerminalAlt+F12 )或主菜单运行这些命令。

本文仅展示与虚拟机交互的最重要命令。 如需查看可用 Vagrant 命令的完整列表,请参阅 Command-Line-Interface

  • 挂起:挂起实例会暂停所有进程并保存虚拟机的当前状态。

    Terminal 中运行 vagrant suspend ,或在主菜单中选择 工具| Vagrant| 挂起

  • 恢复:恢复实例可启动之前挂起的虚拟机。

    Terminal 中运行 vagrant resume ,或在主菜单中选择 工具| Vagrant| 恢复

  • 重新加载:当您修改了 Vagrantfile 且需要 Vagrant 重新加载当前虚拟环境与配置时,需要重新加载实例。

    Terminal 中运行 vagrant reload ,或在主菜单中选择 工具| Vagrant| 重新加载

  • 关闭:关闭实例会停止正在运行的虚拟机。

    Terminal 中运行 vagrant halt ,或在主菜单中选择 工具| Vagrant|停止

  • 销毁:当您需要删除之前创建的环境的所有相关内容时,销毁虚拟机至关重要。 在创建实例过程中预配置的所有资源都将被移除。

    Terminal 中运行 vagrant destroy ,或在主菜单中选择 工具| Vagrant|销毁

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