Scorched是一个基于Ruby的轻量级Web框架，它本身保持了极简的设计哲学，在视图渲染方面并没有像Rails那样提供一套庞大的视图辅助体系。当我们需要在处理请求时向模板传递一些通用的辅助逻辑，例如格式化时间、生成带参数的链接或者判断当前用户权限，如果仅仅依赖控制器实例变量，模板很快就会变得臃肿且难以维护。Scorched::Plugins::ViewContext正是为了解决这一类问题而存在的，它允许开发者将一组方法以模块的形式混入视图的上下文环境中，使得模板在渲染时可以直接调用这些方法，而不必关心方法定义在哪一个控制器里。
ViewContext插件的基本工作原理
从实现机制上看，Scorched在渲染视图时会构建一个特定的求值环境，通常是一个独立的上下文对象或者直接将控制器自身作为绑定对象。Scorched::Plugins::ViewContext所做的核心事情，是把用户提供的模块通过Ruby的include或者extend机制，混入到这个视图上下文对象中。这样一来，模块里定义的所有公开实例方法，都会成为视图作用域里可直接调用的辅助方法。这种方式并没有破坏Scorched原有的渲染流程，只是在上下文对象生成阶段插入了方法注入的逻辑。
理解这一点对于排查方法找不到的错误非常重要。很多初学者在模板里调用辅助方法报出undefined method，往往是因为模块没有被正确挂载到插件上，或者方法被定义成了私有方法。由于视图上下文和控制器实例并不是同一个对象，控制器里定义的私有辅助方法并不会自动出现在视图中，必须经由ViewContext插件显式混入才行。另外，混入的模块如果有实例变量依赖，也需要在调用前通过插件提供的方式完成初始化，否则会出现nil引用问题。
下面是一段最简化的插件接入示例，展示了如何定义一个包含辅助方法的模块并挂载到Scorched应用：
require 'scorched'
require 'scorched/plugins/view_context'
module ViewHelpers
def format_time(time)
time.strftime('%Y-%m-%d %H:%M')
end
def current_user_name
@user && @user[:name] || 'Guest'
end
end
class App < Scorched::Controller
plugin Scorched::Plugins::ViewContext
view_context ViewHelpers
get '/' do
@user = { name: 'Alice' }
render :index
end
end
在ERB模板中调用辅助方法的实践
当模块成功挂载之后，在ERB模板里使用辅助方法就和在控制器里调用普通方法一样自然。由于ERB在Scorched中也是基于同一个视图上下文进行求值的，<%= format_time(Time.now) %>这样的写法可以直接输出格式化后的时间字符串，而不需要先在控制器里赋值给@formatted_time再在模板中输出。这种写法显著减少了控制器与视图之间的数据搬运成本，也让模板自身的可读性提高。
在实际项目中，我们通常会把一类相关的辅助方法组织在同一个模块中，例如专门处理页面链接的LinkHelpers，或者专门处理文本过滤的TextHelpers。如果辅助方法较多，还可以利用Ruby的module嵌套来做逻辑分区，然后在挂载时依次传入多个模块。需要注意的是，不同模块之间如果出现同名方法，后混入的模块会覆盖先混入的方法，因此在团队协作时应约定好命名前缀，避免无意间的方法冲突。
以下是一个ERB模板片段示例，展示如何组合多个辅助方法生成带用户信息的页面头部：
<div class="header"> <span>当前用户：<%= current_user_name %></span> <span>登录时间：<%= format_time(Time.now) %></span> <a href="<%= app_root %>/logout">退出</a> </div>
在这个例子里，app_root也是我们在ViewHelpers中定义的另一个实例方法，用于返回应用的基础路径。可以看出，模板只关心展示结构，所有路径拼接和文本处理都委托给了上下文中的辅助方法。
与控制器实例变量及测试的配合
虽然ViewContext让辅助方法脱离了控制器实例，但辅助方法往往仍需要读取控制器准备好的数据。Scorched在渲染时通常会把控制器里的实例变量同步到视图上下文中，因此在ViewHelpers里可以直接通过@user这样的实例变量访问控制器设置的值。不过为了降低耦合，更推荐的做法是在辅助方法内部做nil保护，并提供合理的默认值，正如前面current_user_name方法中所写的那样。这样即使控制器忘记赋值，模板也不会直接抛出错误。
从测试角度看，传统的在控制器里写辅助逻辑很难单独验证，因为必须构造完整的请求环境。而使用ViewContext之后，由于辅助方法都集中在普通Ruby模块中，我们可以在不启动Web服务器的情况下直接对模块进行单元测试。只需创建一个包含所需实例变量的简单上下文对象，extend该模块，然后断言方法返回值即可。这种可测试性对于保障视图层逻辑质量非常关键，尤其是在涉及金额格式化、权限判断等容易出错的场景。
下面的代码展示了如何脱离框架对ViewHelpers做基本的单元测试：
require 'minitest/autorun'
require_relative 'view_helpers'
class TestViewHelpers < Minitest::Test
def setup
@ctx = Object.new
@ctx.extend ViewHelpers
@ctx.instance_variable_set(:@user, { name: 'Bob' })
end
def test_current_user_name
assert_equal 'Bob', @ctx.current_user_name
end
def test_format_time
t = Time.new(2023, 1, 2, 3, 4)
assert_equal '2023-01-02 03:04', @ctx.format_time(t)
end
end
通过这种方式，视图辅助逻辑获得了与业务代码同等的工程化保障，也更容易在多个Scorched应用之间复用同一套ViewHelpers模块。
ScorchedViewContext辅助方法修改时间：2026-08-19 05:40:28