- 开发环境准备:在本地电脑上搭建开发和测试环境。
- 项目发布:将开发好的代码“打包”以便部署。
- 服务器环境准备:在你要安装网站的服务器上配置运行环境。
- 网站部署:将打包好的文件上传到服务器并进行配置。
- 常见问题与解决方案:解决部署后可能遇到的各种问题。
第一部分:开发环境准备 (本地开发)
在开始之前,你需要在本地电脑上安装好开发工具。

安装 Visual Studio
这是开发 ASP.NET 网站最主要的集成开发环境。
- 下载地址: Visual Studio 官方下载页面
- 版本选择:
- Visual Studio Community (社区版): 免费,功能强大,适合个人开发者、小团队和学术研究。推荐初学者使用。
- Visual Studio Professional (专业版): 付费,功能更全,适用于商业团队。
- Visual Studio Enterprise (企业版): 付费,提供最高级的功能和工具。
- 安装时的工作负载:
- 安装时,请确保勾选了 “.NET 桌面开发” 或 “ASP.NET 和 Web 开发” 工作负载,这会自动安装 .NET SDK、IIS Express 等必要组件。
安装 .NET SDK
Visual Studio 的安装包通常会包含最新的 .NET SDK,但如果你想使用特定版本的 .NET(.NET 6, .NET 8),可以单独下载安装。
- 下载地址: .NET 官方下载页面
- 注意: .NET 6 及更高版本是 长期支持 版本,推荐使用。
第二部分:项目发布
当你完成网站开发并准备部署时,需要将项目发布成一个独立的文件夹。
在 Visual Studio 中发布
-
在 Visual Studio 中,右键点击你的项目解决方案,选择 “发布”。
(图片来源网络,侵删) -
选择发布目标:
- 对于初次部署,选择 “文件夹” 是最简单、最通用的方式,点击“发布”后,Visual Studio 会将所有必要的文件(包括 DLL、配置文件、静态文件等)复制到你指定的本地文件夹中。
- 你也可以选择 “FTP” 或 “Web Deploy”,但这需要你预先配置好服务器的相关信息,我们先以最常用的“文件夹”方式为例。
-
配置发布设置:
- 目标位置: 选择一个本地文件夹来存放发布后的文件。
C:\PublishedWebSite。 - 配置: 通常选择 “Release” (发布版本),因为它会进行代码优化,移除调试信息,性能更好。
- 目标框架: 确保选择你的项目所兼容的 .NET 版本(如 .NET 8.0)。
- 文件发布选项:
- 删除现有文件: 勾选此项,这可以确保每次发布都是一次全新的、干净的部署,避免服务器上遗留旧文件导致的问题。
- 点击“完成”,发布”。
- 目标位置: 选择一个本地文件夹来存放发布后的文件。
发布完成后,你指定的文件夹里就会包含一个可以独立运行的网站文件集。
第三部分:服务器环境准备
你的网站需要一个“家”来运行,这个家就是服务器,你需要根据你的项目类型(.NET Framework 或 .NET Core/5/6/7/8)来配置不同的服务器环境。

项目基于 .NET Framework (ASP.NET MVC 5, Web Forms)
这类项目通常在 Windows Server 的 IIS (Internet Information Services) 上运行。
步骤 1: 安装 IIS 如果你的服务器是 Windows Server,可以通过服务器管理器添加角色和功能来安装 IIS。
- 打开“服务器管理器” -> “管理” -> “添加角色和功能”。
- 按照向导前进,在“选择服务器角色”页面,勾选 “Web 服务器 (IIS)”。
- 在“选择角色服务”页面,确保勾选了以下至少几项:
- Web 服务器
- 应用程序开发: 确保 ASP.NET 和 .NET Extensibility 已勾选。
- 常见 HTTP 功能: 确保 已勾选。
- Web 服务器
- 完成安装。
步骤 2: 安装 .NET Framework 运行时 你的服务器上必须安装与你项目版本匹配的 .NET Framework 运行时。
- 下载地址: .NET Framework 下载页面
- 如果你的项目是用 .NET Framework 4.8 开发的,就需要在服务器上安装 .NET Framework 4.8 运行时。
项目基于 .NET Core / 5 / 6 / 7 / 8 (ASP.NET Core MVC, Blazor)
这类项目是跨平台的,可以在 Windows、Linux 或 macOS 上运行,在 Windows 上,通常部署在 IIS 上。
步骤 1: 安装 IIS 同上,需要安装 IIS,并且确保勾选了 “应用程序开发” -> “ASP.NET Core 8.0” (或其他你使用的版本) 模块。
步骤 2: 安装 .NET Runtime / SDK 你的服务器上只需要安装 .NET Runtime,不需要安装完整的 SDK (除非你需要在服务器上编译代码)。
- 下载地址: .NET 官方下载页面
- 选择 .NET Runtime 版本,下载并安装,如果你的项目是 .NET 8,就下载并安装 .NET 8 Runtime。
第四部分:网站部署
我们将发布好的文件“搬”到服务器上,并告诉 IIS 如何运行它。
上传文件
将第二部分中生成的发布文件夹里的所有内容,通过以下方式之一上传到服务器的指定目录,C:\inetpub\wwwroot\MyWebApp。
- 直接复制粘贴: 如果你有服务器的管理员权限,可以直接在文件资源管理器里操作。
- FTP/SFTP: 使用 FileZilla 等工具连接到服务器,上传文件,这是最常用的方式。
- Web Deploy: 如果你的服务器支持,可以在 Visual Studio 的发布配置中直接使用 Web Deploy 协议进行增量部署。
在 IIS 中创建网站
-
在服务器上,打开 “Internet Information Services (IIS) 管理器”。
-
在左侧的“连接”面板中,右键点击 “网站”,选择 “添加网站”。
-
配置网站信息:
- 网站名称: 给你的网站起一个名字,
MyWebApp。 - 物理路径: 浏览并选择你刚才上传文件的文件夹,
C:\inetpub\wwwroot\MyWebApp。 - 类型: 选择 “应用程序”。
- 应用程序池: 点击右侧的“选择”,创建一个新的应用程序池。
- .NET Framework 项目: 给应用池起名,选择 .NET CLR 版本 (
No Managed Code或v4.0)。 - .NET Core/5+ 项目: 给应用池起名,选择 “无托管代码” (No Managed Code),因为 .NET Core 应用是自托管的,不需要 IIS 的 CLR。
- .NET Framework 项目: 给应用池起名,选择 .NET CLR 版本 (
- 端口: 设置网站的端口号,默认是 80 (HTTP) 或 443 (HTTPS),如果80端口被占用,可以换一个,8080。
- 主机名: 如果你想通过域名访问,在这里输入你的域名,
www.mydomain.com,如果只是内网测试或IP访问,可以留空。
- 网站名称: 给你的网站起一个名字,
-
点击“确定”,网站创建完成。
配置应用程序池 (.NET Core/5+ 项目特有)
对于 .NET Core/5+ 项目,你需要配置应用程序池以启动你的应用。
- 在 IIS 管理器中,选中刚刚创建的网站。
- 在右侧的“操作”面板中,点击 “高级设置...”。
- 找到 “托管模块路径” (Managed Pipeline Mode),将其值修改为你的应用程序的入口点路径。
- 路径格式:
C:\inetpub\wwwroot\MyWebApp\你的项目名.dll C:\inetpub\wwwroot\MyWebApp\MyWebApp.dll
- 路径格式:
- 重启应用程序池: 在 IIS 管
