如何在DEBUG配置下自动加载非压缩版JS文件（ASP.NET Framework）

针对你遇到的手动修改.min后缀容易遗漏的问题，这里提供几个兼容WebForms（.aspx/.ascx）和MVC的实用方案：

方案一：通用脚本路径处理Helper（推荐） #

写一个静态工具类，根据当前调试状态自动转换脚本路径，WebForms和MVC都能直接调用：

1. 编写工具类 #

在项目中添加一个静态类：

using System.Web;

public static class ScriptPathHelper
{
    /// <summary>
    /// 根据调试状态返回正确的脚本路径
    /// </summary>
    /// <param name="minifiedPath">压缩版脚本路径（如~/scripts/abc.min.js）</param>
    /// <returns>DEBUG模式返回非压缩版，否则返回原路径</returns>
    public static string GetCorrectScriptPath(string minifiedPath)
    {
        // 依据Web.config的compilation debug属性判断是否为调试模式
        bool isDebugMode = HttpContext.Current.IsDebuggingEnabled;

        if (isDebugMode && minifiedPath.EndsWith(".min.js", StringComparison.OrdinalIgnoreCase))
        {
            // 移除.min后缀
            return minifiedPath.Replace(".min.js", ".js");
        }

        return minifiedPath;
    }
}

2. WebForms页面中使用 #

在.aspx/.ascx的脚本标签中直接绑定：

<script src="<%= ScriptPathHelper.GetCorrectScriptPath("~/scripts/abc.min.js") %>"></script>

3. MVC视图中使用 #

扩展HtmlHelper让调用更简洁：

using System.Web.Mvc;
using System.Web.Mvc.Html;

public static class HtmlHelperScriptExtensions
{
    public static MvcHtmlString Script(this HtmlHelper htmlHelper, string minifiedPath)
    {
        string correctPath = ScriptPathHelper.GetCorrectScriptPath(minifiedPath);
        // 解析相对路径为绝对路径
        string resolvedPath = htmlHelper.ResolveUrl(correctPath);

        var scriptTag = new TagBuilder("script");
        scriptTag.Attributes["src"] = resolvedPath;
        return MvcHtmlString.Create(scriptTag.ToString());
    }
}

然后在Razor视图中调用：

@Html.Script("~/scripts/abc.min.js")

方案二：Web.config配置变换 #

利用Web.config的环境变换功能，通过配置项控制后缀：

1. 主Web.config配置 #

<appSettings>
  <!-- 默认使用压缩版后缀 -->
  <add key="JsFileSuffix" value=".min.js" />
</appSettings>

2. Web.Debug.config变换 #

<appSettings>
  <!-- DEBUG模式替换为非压缩版后缀 -->
  <add key="JsFileSuffix" value=".js" xdt:Transform="SetAttributes" xdt:Locator="Match(key)" />
</appSettings>

3. 页面中引用 #

WebForms：

<script src="~/scripts/abc<%= System.Configuration.ConfigurationManager.AppSettings["JsFileSuffix"] %>"></script>

MVC视图：

<script src="~/scripts/abc@System.Configuration.ConfigurationManager.AppSettings["JsFileSuffix"]"></script>

注意：此方案需要将脚本文件名和后缀拆分，灵活性不如方案一。

方案三：改用ASP.NET自带Bundle（可选） #

如果可以替换现有压缩机制，ASP.NET自带的BundleConfig默认支持：

• DEBUG模式：加载未压缩的原始JS文件
• RELEASE模式：自动合并压缩

只需在App_Start/BundleConfig.cs中配置：

public static void RegisterBundles(BundleCollection bundles)
{
    bundles.Add(new ScriptBundle("~/bundles/abc").Include(
                "~/scripts/abc.js"));

    // 启用Bundle的压缩优化（RELEASE模式自动生效）
    BundleTable.EnableOptimizations = !HttpContext.Current.IsDebuggingEnabled;
}

然后页面引用Bundle：
WebForms：

<%: Scripts.Render("~/bundles/abc") %>

MVC视图：

@Scripts.Render("~/bundles/abc")

此方案适合愿意迁移到自带压缩流程的场景，无需手动维护.min文件。

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