Skip to content
| Marketplace
Sign in
Visual Studio Code>Other>IIS Web DeployNew to Visual Studio Code? Get it now.
IIS Web Deploy

IIS Web Deploy

王栋(WangDong)

|
1 install
| (0) | Free
将编译产物通过 Web Deploy 发布到 IIS 网站
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

IIS Web Deploy

Windows 本机 VS Code 扩展:将已经编译好的文件夹直接发布到 IIS 网站,不需要打开 Visual Studio。

安装 Web Deploy

在左侧配置编辑中点击 安装 Web Deploy,按微软安装窗口提示接受许可、选择安装内容并完成安装;安装可能需要管理员权限。

已有 Web Deploy 时直接点击 自动检测 回填程序路径;新建目标也会尝试自动检测。已有目标保留原有程序路径,仅在点击检测或安装按钮后回填新的路径。检测或安装回填路径后,须再次验证并保存目标。

内置安装器支持 Windows x64,需要 .NET Framework 4.0 或更高版本。首次使用仍须安装 Web Deploy 客户端;本插件不提供免安装的拆分 EXE/DLL。微软的 REDIST.txt 要求完整 MSI 分发。微软安装包受其独立许可约束,不适用插件源码的 MIT 许可,具体见 resources/installers/MICROSOFT-LICENSE.txt 和 REDIST.txt。服务端 IIS/WMSvc 仍须单独配置。

若存在随 Visual Studio 安装的旧版本,新版安装器可能要求先手动卸载;插件不会替用户执行卸载。版本要求和安装说明见 微软 Web Deploy 下载页。

配置编辑区域默认排在侧栏顶部并展开,首次布局按约 5:1 的高度比例分配给配置编辑和发布目标。VS Code 已保存的布局会优先保留;升级后若仍偏矮,可拖动两个区域之间的分隔线调整。窗口高度有限时,表单支持滚动。

发布步骤

  1. 打开需要发布的本地项目,先构建:前端通常运行 npm run build 生成 dist;ASP.NET Core 运行 dotnet publish -c Release -o ./publish。本扩展不执行构建。
  2. 点击 VS Code 左侧活动栏的 Web Deploy 云上传图标,点击“新建发布目标”(或面板顶部的 +)。在左侧“配置编辑”表单中一次填写名称、dist / publish 目录、HTTPS 发布地址、IIS 网站名称、账号、密码和 msdeploy.exe 路径。目录和程序可直接填写,也可点击浏览选择。
  3. 根据需要选择保留服务器 appsettings*.json / web.config。首次部署 .NET 时需要 web.config 和应用配置,请选择覆盖或预先在服务器准备文件。
  4. 点击 验证并保存,默认先检查本地信息,再使用 -whatif 连接服务器并检查发布权限;成功后才保存。失败时错误显示在表单内,填写内容保留。取消“连接服务器验证”可仅检查本地信息并保存,不代表服务器可连接。验证不会修改服务器,但需要完整读取待发布目录,大目录可能耗时。
  5. 点击目标旁的 云上传图标(发布),核对源路径、服务器和网站,再确认发布。通知支持取消;取消不能回滚已完成的部分变更。

点击目标或其编辑图标,即可在左侧表单修改;展开目标可查看配置。面板顶部提供刷新和日志按钮,右键目标可删除配置。表单也提供已保存目标的预览和发布操作。正式发布仍保留一次覆盖确认,不再逐个弹框询问配置。升级到 0.3.0 后,同一工作区已有的发布目标和密码继续保留。若图标未出现,先重载 VS Code 窗口,并检查活动栏菜单是否隐藏了 Web Deploy。

配置存在 VS Code 工作区状态,密码单独存入 SecretStorage。再次打开配置编辑时,会检查密码是否存在:已保存时密码框显示“••••••••(已保存)”占位提示,留空会复用原密码,输入新密码可替换。实际密码不会回传到表单;若未检测到密码,则提示重新输入。删除目标会清除保存的密码。移动工作区后可能需要重新输入密码。

IIS 服务器要求

服务器应配置 IIS、Web Deploy Handler、Web Management Service,开放 HTTPS 发布端口(通常 8172),并给账号配置目标网站及子目录的发布权限和 contentPath 委派规则。地址示例:https://server.example.com:8172/msdeploy.axd。网站名称必须与 IIS 中一致,子目录在独立字段填写。

新建目标默认勾选 允许不受信任的服务器证书,已有目标及导入的目标保留其原有选择。启用后会为验证、预览及正式发布添加 -allowUntrusted,跳过服务器证书信任校验,仅应在确认服务器可信时使用。建议在 Web Management Service 配置有效、受客户端信任且匹配发布域名的证书,并取消勾选。参见 Microsoft Web Deploy 参数说明。

默认 DoNotDeleteRule 保留服务器额外文件,同名文件仍会更新。扩展不配置 IIS、不创建网站、不提供备份回滚、不部署数据库,也不自动停止站点;.NET 文件占用时需自行安排停机或服务器端部署策略。先在测试站点验证。服务器前提见 Microsoft IIS Web Deploy 配置说明。

密码不会写入发布配置或输出命令,但 Web Deploy Basic 身份验证需要通过子进程参数传入密码,本机有相应权限的进程可能读取。输出进行分块脱敏。不要将项目根目录作为发布目录;只使用专用编译输出目录。

字段(包括密码)暂不支持单引号、双引号及换行;可使用空格、中文、逗号等常用字符。日志按完整行采用 UTF-8 优先、GBK 兼容的解码策略,少量编码存在歧义时可能显示异常。

本地自动化测试含真实 msdeploy 的只读预览(安装后在 Windows 自动运行),但不能替代真实 IIS 服务器联调;交付不代表已经发布到生产网站。

发布到网站子目录

在配置编辑中,IIS 网站名只填写网站名称,例如 Default Web Site,在 网站子目录(可选) 填写 admin 或 api/v1。目标分别为 Default Web Site/admin、Default Web Site/api/v1;留空仍发布到网站根目录,旧配置保持原有行为。表单、发布目标列表、日志和发布确认会显示目标路径。修改后先验证并保存,再发布。

子目录使用相对路径,不加开头、末尾斜线,不接受磁盘路径、URL、反斜线或 ..。WMSvc 连接的 site 参数仍为根网站名,仅文件同步目标变为网站下的指定目录,不会同时更新网站根目录。远端账号需要有对应目录的权限。

本功能仅同步编译产物,不会创建或配置 IIS 子应用、虚拟目录、应用程序池。部署 .NET 子应用时需在服务器预先配置相应应用;前端部署到 /admin/ 等路径时,需按项目构建工具设置 base/publicPath 和路由基路径。

工作区配置、排序与导入导出

发布目标仍按工作区隔离,不默认显示其他工作区的配置。可拖动发布目标排序:拖到另一个目标上时插入其前方,拖到列表空白处时移到末尾;支持多选后一起拖动。顺序会在当前工作区保存,编辑目标不会改变排序。

配置编辑顶部提供三个入口,发布目标标题栏的菜单也提供相同操作:

  • 导入其他工作区配置:先选择来源工作区,再勾选要复制的目标。仅列出安装此版本后打开并登记过的本地工作区;看不到旧工作区时,先打开它一次。来源配置保持不变,导入项使用新 ID,不覆盖当前目标。
  • 导出配置:选择目标及 JSON 文件位置。按当前顺序导出,文件不包含密码,但包含服务器地址、用户名及本地路径,请妥善保存。
  • 导入配置文件:选择本插件导出的 JSON,再选择需要导入的目标。适合备份恢复和换电脑,不会自动发布。

密码不会随导入导出复制,导入后请检查源目录与 Web Deploy 程序路径,输入密码并验证保存。用于列出其他工作区的非密码配置快照保存在 VS Code 当前用户的 globalState 中;实际发布目标和排序仍保存在各工作区 workspaceState。此目录不扫描其他工作区数据库,也不自动同步到其他电脑。

作者联系方式

作者:WangDong

邮箱:761672658@qq.com

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft