C#执行JS脚本：Jint库安装与基础调用教程

在.NET应用程序中执行动态逻辑、用户自定义规则或复用前端计算逻辑时，引入轻量级的JavaScript解释器是一个常见需求。Jint是一个完全使用C#编写且符合ECMAScript规范的解释器，不需要在目标机器上安装Node.js或依赖外部原生运行时，可以直接嵌入到任何现代.NET控制台、Web API或桌面项目中。本文将详细演示Jint的安装方式以及完成基础脚本执行的核心用法。

图1：Jint与.NET宿主环境架构与交互关系

Jint 库的安装配置

Jint 已在 NuGet 官方平台公开发布。在支持 .NET Standard 或 .NET 6/7/8/9 的项目中，均可通过包管理器直接获取并引用。

方法一：通过 .NET CLI 命令行安装

在项目所在目录打开终端，运行如下命令：

dotnet add package Jint

方法二：通过 Visual Studio 包含包管理器控制台

如果在 Visual Studio 环境下开发，打开“程序包管理器控制台”（Package Manager Console），执行：

Install-Package Jint

执行完成后，项目文件（.csproj）中会自动增加对应的 <PackageReference Include="Jint" Version="..." /> 依赖节点。

图2：Jint从安装到结果提取的标准操作步骤

Jint 基础调用与示例

在项目中引入 using Jint; 命名空间后，即可创建 Engine 实例执行脚本。

1. 执行简短脚本并读取返回值

最直接的使用场景是执行表达式并求值。Engine.Evaluate 方法可对一段表达式求值并返回对应的 JsValue：

using System;
using Jint;

class Program
{
    static void Main()
    {
        // 1. 初始化引擎
        var engine = new Engine();

        // 2. 执行数学表达式并获取结果
        var result = engine.Evaluate("10 * 20 + 5").AsNumber();
        Console.WriteLine($"计算结果: {result}"); // 示例输出: 计算结果: 205
    }
}

2. C#与JavaScript的双向数据交互

实际开发中，通常需要将C#中的数据作为变量注入到JavaScript环境中，或者将C#方法暴露给脚本调用。Jint 提供了 SetValue 方法：

using System;
using Jint;

class Program
{
    static void Main()
    {
        var engine = new Engine();

        // 将 C# 变量与委托注入到 JS 作用域
        engine.SetValue("baseSalary", 8000)
              .SetValue("bonusRatio", 0.15)
              .SetValue("logMessage", new Action<string>(msg => Console.WriteLine($"[JS Log] {msg}")));

        // 运行多行脚本
        string script = @"
            logMessage('开始计算工资...');
            var total = baseSalary * (1 + bonusRatio);
            total;
        ";

        var totalSalary = engine.Evaluate(script).AsNumber();
        Console.WriteLine($"最终计算金额: {totalSalary}"); // 示例输出: 最终计算金额: 9200
    }
}

图3：C#原生类型与Jint内部JsValue的互转映射

常见限制与安全注意事项

在生产环境中引入脚本执行时，通常需要注意以下几个安全与稳定性边界：

• 死循环与资源耗尽：如果用户输入的脚本包含 while(true) 等死循环，会阻塞调用线程。可以通过在初始化引擎时配置 TimeoutInterval 或 LimitMemory 进行防御。
• 线程安全：Engine 实例并不是线程安全的。多个线程不能同时操作同一个 Engine 实例；高并发场景建议使用对象池（Object Pool）或按请求独立实例化。
• 对象生命周期：频繁创建和销毁 Engine 可能会带来一定的垃圾回收压力，对于固定脚本建议利用抽象语法树预编译或适度复用。

图4：Jint核心特性与开发调用要点归纳