如何在Visual Studio Code中本地运行已发布的ASP.NET WebForms站点

1. 安装必备运行依赖 #

ASP.NET WebForms基于*.NET Framework*运行，目标电脑需要提前安装两个核心组件：

• 与站点开发编译时版本一致的.NET Framework 4.x运行时
• 本地Web托管工具，二选一即可：
  • 轻量调试选IIS Express
  • 稳定运行选完整IIS（Windows系统自带，需要手动开启功能）

2. 用VS Code打开站点目录 #

• 启动VS Code，点击顶部菜单「文件」-「打开文件夹」
• 选择拷贝到本地的已发布站点根目录（该目录需直接包含web.config、default.aspx等根目录文件）

3. 配置并启动站点 #

方案A：IIS Express运行（推荐本地调试用） #

• 在VS Code扩展面板搜索安装IIS Express扩展，安装完成后重启VS Code
• 在VS Code中打开站点根目录下的default.aspx文件
• 按快捷键Ctrl+F5，或右键编辑器空白区域选择「启动IIS Express」
• 扩展会自动启动本地站点服务并分配随机端口，默认会自动唤起浏览器打开首页；如果没有自动弹出，可手动在浏览器访问http://localhost:XXXX/default.aspx（XXXX为VS Code控制台输出的端口号）

方案B：完整IIS挂载运行 #

• 打开Windows「启用或关闭Windows功能」面板，勾选「Internet Information Services」下的Web管理工具、万维网服务全量相关组件，等待安装完成
• 启动IIS管理器，右键左侧「网站」节点选择「添加网站」
• 按提示填写自定义站点名，物理路径选择站点根目录，设置一个未被占用的端口（例如8080），IP保持默认127.0.0.1即可
• 确认创建后，右键新添加的站点选择「管理网站」-「启动」
• 直接在浏览器访问http://localhost:8080/default.aspx即可，VS Code仅需用于代码编辑，修改后刷新浏览器即可生效

常见问题排查 #

• 若提示权限不足：给站点根目录添加本地Users用户组的读取、运行权限
• 若提示web.config配置错误：确认安装的.NET Framework版本与站点开发版本一致，若用IIS托管需要在对应应用程序池的高级设置中，将.NET Framework版本调整为匹配版本
• 非Windows系统需安装Mono运行时托管站点，兼容性弱于Windows原生环境

内容的提问来源于stack exchange，提问作者user2903753