Sinatra — 用 Ruby 三行代码起一个 web 服务

是什么

Sinatra 是一个用 Ruby 写的极简 web 框架。日常类比：如果 Rails 像一栋装修好的精装公寓——开门就能住，但你想改格局得先拆墙；那 Sinatra 像一间空毛坯房——只给你水电和承重墙，桌椅家具完全自己挑。

最经典的”三行 Hello World”长这样：

require 'sinatra'
get '/' do
  '你好，世界'
end

把这三行存成 app.rb，跑 ruby app.rb，浏览器打开 http://localhost:4567 就能看到”你好，世界”。没有项目骨架、没有配置文件、没有目录结构——这就是 Sinatra 的卖点。

不理解 Sinatra，下面这些事都没法解释：

Sinatra 的设计可以拆成三块：

DSL 路由：把 HTTP 动词当成方法名，get '/path' do ... end 就是一条路由。类比：像在白板上贴便利贴——左边写”什么请求”，右边写”怎么回答”，一对一对应。
基于 Rack：Rack 是 Ruby 社区”web 服务器和应用之间的统一接口”，类似 Java 的 Servlet。Sinatra 自己其实就是一个 Rack 应用，所以可以无缝接入任何 Rack 中间件（鉴权 / 日志 / 限流）。
classic vs modular 两种风格：classic 是上面那种顶层 get '/' 写法，一个文件搞定；modular 是 class MyApp < Sinatra::Base 把应用包装成类，可以在一个进程里跑多个独立 app。

require 'sinatra'
require 'json'
get '/api/users/:id' do
  content_type :json
  { id: params['id'], name: '张三' }.to_json
end

逐部分解释：

require 'sinatra'
post '/payment' do
  sleep 1
  status 200
  '{"status":"ok","tx_id":"mock-001"}'
end

前端联调时，第三方支付 API 还没接通，用 Sinatra 起一个假端点。sleep 1 模拟网络延迟，status 200 显式设状态码。整个文件 5 行，前端就能照常调试，不用等真接口好。

class StatusApp < Sinatra::Base
  get '/health' do
    "OK，已处理 #{$counter} 个任务"
  end
end
Thread.new { StatusApp.run! port: 9292 }

这是 modular 风格——把 Sinatra 应用包成类，丢到子线程里跑。主程序继续做后台任务，运维想看健康状态就 curl localhost:9292/health。Sinatra 在这里只占 6 行，不会喧宾夺主。

改代码不自动重载：classic 风格下编辑路由后，必须 Ctrl+C 重启 ruby app.rb 才生效。开发时要配合 rerun 或 shotgun 这类工具，否则会以为”我代码没存上”。
路由的尾斜杠敏感：get '/users' 和 get '/users/' 是两条不同路由，浏览器地址栏后面多打一个 / 就 404，新人常常奇怪为什么 GET 不到。
classic 和 modular 不能混：一个进程里只能存在一个 classic 应用（顶层 get/post）。想跑多个 app 必须全部改成 modular（class X < Sinatra::Base），半新半旧会冲突。
没自带 ORM / 表单验证 / 资产打包：复杂项目要自己拼 Sequel + Tilt + Rack-Protection，很快就变成”自己手写的迷你 Rails”——这时候该认真考虑直接上 Rails。

适用：

不适用：

2007 年：Blake Mizerany 在 GitHub 开源 Sinatra，名字致敬美国歌手 Frank Sinatra（项目里很多类比和歌名相关）。
2008-2009 年：Heroku 平台早期把 Sinatra 列为头等公民，“几行代码 + git push 上线”成为流行 demo 模式。
2010 年：Express.js（Node）和 Flask（Python）相继发布，路由 DSL 几乎照搬 Sinatra——app.get('/path', handler) 就是它的 JavaScript 翻译。
2014 年起：Rails 自己也吸收了”挂载 Rack 应用”的能力，Sinatra 应用可以作为 Rails 的一部分跑——两者从对立变成互补。
2020 年代：Hono / Bun.serve / Cloudflare Workers 这些新框架的最小路由 API 仍然是 Sinatra 这一脉。

“约定优于配置”和”最少惊讶”是两条平行哲学——Rails 选前者、Sinatra 选后者，没有谁更对，只看场景
DSL 是把”领域语义”压到代码外观上的技巧——get '/path' do ... end 一眼能看懂，比 app.add_route(GET, '/path', handler) 直观
基于通用接口（Rack / WSGI / Servlet）的小框架天然能复用整个生态——这是它们能用很少代码做很多事的根因
极简框架不等于学得快——它假设你懂 HTTP 和 Rack，对真新手反而 rails 这类大框架更友好