Vagrant

在此页面中，为 WebStorm 启用 Vagrant 支持，指定 VagrantFile 的位置，并管理用于创建虚拟 box（实例）的 Vagrant base box 列表。

开始之前：

请确保 Vagrant 和 Oracle 的 VirtualBox 已按照 Vagrant：使用可复现的开发环境进行开发中的说明下载、安装并配置在您的计算机上。
请确保以下可执行文件的上级文件夹已添加到系统 PATH 变量中：
- 来自 Vagrant 安装的 vagrant.bat 或 vagrant 。此操作应由 Vagrant 安装程序自动完成。
- 来自 Oracle 的 VirtualBox 安装的 VBoxManage.exe 或 VBoxManage 。

项目

描述

Vagrant 可执行文件

指定可执行文件的完整路径地址：Windows 使用 vagrant.bat ，Unix 和 macOS 使用 vagrant 。您可以手动输入路径，或点击浏览按钮在打开的对话框中定位所需文件。

实例文件夹

在此指定已执行任务 vagrant init 且已初始化并存储 Vagrantfile 的目录的完整路径。

Vagrantfile 是一个配置文件，定义了所需的实例（虚拟机）。该文件包含虚拟 IP 地址、端口映射以及分配的内存大小。该文件可指定哪些文件夹被共享，并应安装哪些第三方软件。根据 Vagrantfile ，您的实例（虚拟机）将基于所选 Vagrant base box 进行配置与预配，并部署到您的计算机。 Vagrantfile 是通过 vagrant init 命令创建的。

无论是通过 vagrant up 命令调用实例（实例）（虚拟机）的创建，还是通过工具 | Vagrant | 启动菜单选项，WebStorm 都将在实例文件夹字段中指定的目录中查找 Vagrantfile 。有关详细信息，请参见 http://docs.vagrantup.com/v2/vagrantfile/。

您可以在任意目录中创建 Vagrantfile 并将其指定为实例文件夹。如果该字段为空，WebStorm 将把项目根目录视为实例文件夹，并在其中查找 Vagrantfile 。

提供程序

使用此字段指定 vagrant up 命令所使用的提供程序。如果此字段为空，将使用默认提供程序。

环境变量

点击省略号按钮或按下 Shift+Enter 以指定用于配置提供程序行为的 shell 变量。

Boxes 与 Plugins 选项卡

Boxes

此列表显示 WebStorm 中可用的预定义 Vagrant base box。

每项表示一个 Vagrant base box ，Vagrant 在其上配置并启动其实例（虚拟机）。此列表中的条目对应于命令 vagrant box list 的输出结果。


	`Alt+Insert`	点击此按钮以下载新的 base box。该命令对应于 `vagrant box add <name> <URL>`。默认情况下，WebStorm 会建议使用 lucid32 box 的 URL
	`Alt+Delete`	点击此按钮以移除所选的 Vagrant base box。 box 及其嵌套文件将从磁盘中被物理删除。该命令对应于 `vagrant box remove <name>`

Plugins

使用此表查看和修改可用插件列表。


	`Alt+Insert`	点击此按钮安装新的 Vagrant 插件。
	`Alt+Delete`	点击此按钮移除所选插件。
		点击此按钮更新所选插件。
		使用此按钮为所选插件附加许可证。

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