为何.NET 6.0的ASP.NET Core项目会提示不应引用System.Web命名空间？

你收到的警告是因为System.Web是传统.NET Framework下ASP.NET的专属命名空间，ASP.NET Core是完全重构的跨平台框架，和旧版ASP.NET的依赖体系不兼容，强行引用System.Web不仅会引入冗余的旧框架依赖，还可能在跨平台场景下出现兼容性问题，所以官方明确不推荐在ASP.NET Core项目中使用它。

针对HTTP编码/解码需求，ASP.NET Core提供了更轻量、适配性更好的替代方案：

1. URL编码/解码 #

直接使用System.Net.WebUtility类的静态方法，这是.NET Core内置的，无需额外安装包：

using System.Net;

// URL编码
var urlEncoded = WebUtility.UrlEncode("包含特殊字符的字符串，比如?&=");
// URL解码
var urlDecoded = WebUtility.UrlDecode(urlEncoded);

2. HTML编码/解码 #

同样使用System.Net.WebUtility，替代原HttpUtility.HtmlEncode/HtmlDecode：

using System.Net;

// HTML编码（防止XSS注入）
var htmlEncoded = WebUtility.HtmlEncode("<script>alert('恶意脚本')</script>");
// HTML解码
var htmlDecoded = WebUtility.HtmlDecode(htmlEncoded);

3. 查询字符串处理（进阶） #

如果需要解析或构建URL查询字符串，ASP.NET Core推荐使用Microsoft.AspNetCore.WebUtilities.QueryHelpers，这个类更贴合Core的路由场景：

using Microsoft.AspNetCore.WebUtilities;

// 构建查询字符串
var queryParams = new Dictionary<string, string>
{
    { "key1", "value1" },
    { "key2", "value2" }
};
var baseUrl = "https://example.com/api";
var fullUrl = QueryHelpers.AddQueryString(baseUrl, queryParams);

// 解析查询字符串
var queryString = "?key1=value1&key2=value2";
var parsedParams = QueryHelpers.ParseQuery(queryString);
var value1 = parsedParams["key1"];

注意：QueryHelpers需要引用Microsoft.AspNetCore.WebUtilities NuGet包，如果你的项目是ASP.NET Core Web应用，通常已经默认包含了这个依赖。

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