用 Sinatra 揭开 Rails 的「魔法」curriculum 中 Ruby Web 框架入门的第一课【免费下载链接】curriculumThe open curriculum for learning web development项目地址: https://gitcode.com/GitHub_Trending/cu/curriculum本文以课程仓库中 sinatra.md 为主体结合同目录下的 project_sinatra.md、rails_basics.md 等配套文档展开。学习 Ruby on Rails 之前先亲手用 Sinatra 搭建路由、组织视图、使用会话能帮你把 Rails 中那些看似「魔法」的机制变成一个个清晰可见的显式步骤从而大幅降低 Rails 的学习曲线。读完本文你将掌握如何从零启动一个 Sinatra 应用、理解 routes/views/sessions 三大核心概念、在云端环境运行应用、部署到 Heroku以及把 Ruby 课程中的命令行项目改造成 Web 应用的方法。为什么在学 Rails 之前要先学 SinatraRails 的「魔法」来自深层的抽象初学 Rails 的人最头疼的一件事就是搞不清 Rails 到底替你在后台做了多少事。正如 rails_basics.md 所说Rails 本质上是「一堆帮你处理 Web 应用常见问题的 Ruby 代码」其核心哲学是convention over configuration约定优于配置——框架的作者替你做了一大批关于「代码该如何组织、程序该如何运行」的决策。Rails 的强大之处在于你能以极快的速度开发复杂应用而这份速度正来源于它后台为你完成的大量工作。这些工作被封装在层层的抽象之下于是产生了初学者感知到的「魔法」。对这种「魔法」越是雾里看花就越难真正理解请求是如何进入应用、如何被处理、又如何变成 HTML 返回给浏览器的。RackRails 与 Sinatra 的共同基座关键线索在于Sinatra 和 Rails 一样都构建在 Rack 之上。Rack 是 Ruby 社区中连接 Web 服务器与应用代码的底层接口层。既然底层地基相同就可以把 Sinatra 理解为 Rails 的「裸版」bare bones versionRails为你生成完整的文件结构约定路由、控制器、视图、模型的摆放位置封装了大量中间件和基础设施Sinatra几乎没有「魔法」一切都很显式——你亲手写路由、亲手组织视图、亲手管理会话。这正是 sinatra.md 主张「先 Sinatra 后 Rails」的根本原因在 Sinatra 里亲手搭建一次路由和视图之后Rails 里那套看似复杂的文件结构与调用方法就会变得顺理成章。学习目标本课你要弄懂的三件事在开始动手之前先记住本课的学习目标Learning Outcomes完成练习后用它们自测什么是路由routesURL 与处理代码之间的映射关系决定「某个地址的请求由哪段代码响应」。什么是视图views负责把数据渲染成 HTML 呈现给用户的那一层。什么是 Sinatra 中的会话sessions如何在多个请求之间保存用户状态例如游戏进度、猜测次数以及如何使用它。这三者也是后续 project_sinatra.md 中两个实战项目Caesar Cipher 网页版、Web 游戏的核心依赖。第一个 Sinatra 应用frank_says.rb 从零跑通编写代码按官方首页的指引创建一个名为frank_says.rb的文件写入以下内容require sinatra get /frank-says do Put this in your pipe smoke it! end这段代码只有三行却完整地演示了 Sinatra 最核心的机制require sinatra引入 Sinatra 库并让后续的路由声明语法DSL领域特定语言生效get /frank-says do ... end声明一个GET 路由——当浏览器请求/frank-says这个地址时块内的代码被执行块的返回值Put this in your pipe smoke it!会被直接作为 HTTP 响应体返回给浏览器。对比 Rails 中处理一个 GET 请求需要「路由配置 → 控制器 action → 视图模板」的完整链路见 project_basic_rvc.md 中resources :users、UsersController#index、app/views/users/index.html.erb的逐步报错排查过程Sinatra 把「地址 → 响应」的映射压缩到了最小显式单元这就是「无魔法」的直观体现。安装并运行在命令行中执行gem install sinatra安装成功后运行刚才创建的文件ruby frank_says.rb然后打开浏览器访问http://localhost:4567/frank-says你会在页面上看到路由块中返回的那句话。默认端口是4567——这是 Sinatra 开发服务器的约定端口注意它与 Rails 默认的3000不同。在云开发环境Cloud9 等中运行如果你没有本地环境而是使用云端 IDE文档写作时以 Cloud9 为例同样的代码只需调整启动参数让服务器监听云端环境提供的 IP 与端口ruby frank_says.rb -o $IP -p $PORT其中-o指定监听地址$IP为环境变量-p指定监听端口$PORT为环境变量。启动后终端会给出访问链接你只需在浏览器地址栏追加/frank-says即可访问到该路由。深入理解三大核心概念路由RoutesURL 与代码的映射表路由是 Sinatra 的灵魂。get /frank-says do ... end的本质是「当收到一个针对路径/frank-says的 GET 请求时执行这个块」。Sinatra 支持多种 HTTP 动词get、post、put、delete等也支持在路径中使用动态参数例如/users/:id。你可以声明任意数量的路由每个路由块返回的内容就是响应体。理解这一点后再看 Rails 的config/routes.rb中一行resources :users就能瞬间生成 7 条 RESTful 路由对应 7 个控制器 action如index、show、create……你会意识到Rails 只是把 Sinatra 中你手写的那张「映射表」用约定帮你批量生成了而已。视图Views数据的呈现层在 Sinatra 中视图就是你自己组织的模板文件。路由块可以调用视图渲染例如配合 ERB 模板把数据注入 HTML。视图的职责边界与 Rails 一致控制器/路由负责逻辑与数据视图负责呈现。正因你在 Sinatra 里亲手决定视图文件放哪、如何渲染之后进入 Rails 看到app/views/...的固定目录约定时就不会再觉得那是凭空冒出来的规则。会话Sessions跨请求记住状态HTTP 是无状态的每个请求彼此独立。会话session机制通过在服务器端保存数据、在客户端通过 Cookie 携带会话标识让应用能「记住」用户。在 Sinatra 中使用会话通常需要启用会话支持如enable :sessions或在应用启动时配置 session 中间件在路由块中通过 session 哈希读写数据例如session[:guess_count]。project_sinatra.md 中特别提示做 Web 游戏Mastermind、Hangman时「你很可能需要再看一遍 Sinatra 中 sessions 的用法」——因为游戏状态已猜次数、当前单词、历史记录必须在多次请求之间持续存在这正是会话的典型应用场景。部署到 Heroku把应用送上公网project_sinatra.md 开篇给出了将 Sinatra 应用部署到 Heroku 的完整要点这是让应用「真正跑在互联网上」的必经环节步骤整理如下准备config.ru这个 Rack 入口文件需要require你的主应用文件例如 Jumpstart 教程里的web_guesser.rb。Rack 服务器启动时正是从config.ru加载应用。处理sinatra/reloader本地开发时常用sinatra/reloader实现代码改动自动重载。推送前必须移除或注释掉该行更优雅的做法是把它包在条件判断里if development? require sinatra/reloader end这样在 Heroku 的生产环境非 development 模式下它自动失效而本地开发照常生效。Gemfile 与依赖创建Gemfile声明依赖后执行bundle install生成并提交锁定文件。推送部署将文件提交到 git 后执行git push heroku master完成部署。这一套流程对 Rails 应用同样成立Rails 项目也有config.ru、Gemfile 与同样的部署管线先在小体量的 Sinatra 应用上跑通它能为你后续部署 Rails 应用建立完整的心智模型。实战项目把 Ruby 命令行程序变成 Web 应用项目一Caesar Cipher Reloaded凯撒密码网页版你已经在 Ruby 课程中实现过凯撒密码见 project_caesar_cipher.md其核心是「输入字符串与位移因子对每个字母做右移替换并保持大小写」。现在用 Sinatra 为它做一个简单前端新建一个 Sinatra 项目可以先从 Jumpstart 教程的 hello world 起步确认环境正常仅需一个视图加几条路由即可完成一个路由渲染表单视图另一个路由接收参数、调用你已有的加密逻辑并渲染结果用本文开头的部署步骤将应用部署到 Heroku。这个项目的价值在于「复用」把纯 Ruby 的算法代码与 Web 层解耦验证你已经能独立完成「接收请求 → 处理逻辑 → 渲染视图」的完整闭环。项目二另一个 Web 游戏Mastermind 或 Hangman从你在 Ruby 课程中完成的 Mastermind 或 Hangman 游戏中选择一个为它构建 Web 前端UI 实现完全由你决定保持纯文本可接受但既然上了 Web可以引入图片让界面更精致务必复习 Sinatra 中 sessions 的用法——游戏状态必须跨请求保存这是本项目成败的关键别忘了让朋友们都来玩你的游戏参考资源与进阶路径本课作业还要求阅读 Sinatra 官方 README 的前八个章节直到第 8 节 Helpers 为止——官方 README 几乎是 Sinatra 全部知识的浓缩适合作为实践过程中的参考手册。此外Jumpstart Lab 的 Web Guesser 教程一个数字猜谜游戏及其文末的 Extensions 扩展练习是与本课配套的经典动手材料文中也提到 Ruby Monstas 的 Sinatra 入门与会话专题可作为难度更温和的补充读物。值得留意的是sinatra.md 与 project_sinatra.md 目前存放于仓库的archive/old_lessons归档目录下。归档见 archive/README.md通常意味着内容被改写、替换或移出当前课程主线但这并不削弱其教学价值——作为「理解 Rails 内部机制」的预备材料先亲手写完一个无魔法的 Sinatra 应用再走进 Rails 的世界你将会对控制器、视图、路由、会话与部署有远超「照葫芦画瓢」的把握。【免费下载链接】curriculumThe open curriculum for learning web development项目地址: https://gitcode.com/GitHub_Trending/cu/curriculum创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 用 Sinatra 揭开 Rails 的「魔法」：curriculum 中 Ruby Web 框架入门的第一课
用 Sinatra 揭开 Rails 的「魔法」curriculum 中 Ruby Web 框架入门的第一课【免费下载链接】curriculumThe open curriculum for learning web development项目地址: https://gitcode.com/GitHub_Trending/cu/curriculum本文以课程仓库中 sinatra.md 为主体结合同目录下的 project_sinatra.md、rails_basics.md 等配套文档展开。学习 Ruby on Rails 之前先亲手用 Sinatra 搭建路由、组织视图、使用会话能帮你把 Rails 中那些看似「魔法」的机制变成一个个清晰可见的显式步骤从而大幅降低 Rails 的学习曲线。读完本文你将掌握如何从零启动一个 Sinatra 应用、理解 routes/views/sessions 三大核心概念、在云端环境运行应用、部署到 Heroku以及把 Ruby 课程中的命令行项目改造成 Web 应用的方法。为什么在学 Rails 之前要先学 SinatraRails 的「魔法」来自深层的抽象初学 Rails 的人最头疼的一件事就是搞不清 Rails 到底替你在后台做了多少事。正如 rails_basics.md 所说Rails 本质上是「一堆帮你处理 Web 应用常见问题的 Ruby 代码」其核心哲学是convention over configuration约定优于配置——框架的作者替你做了一大批关于「代码该如何组织、程序该如何运行」的决策。Rails 的强大之处在于你能以极快的速度开发复杂应用而这份速度正来源于它后台为你完成的大量工作。这些工作被封装在层层的抽象之下于是产生了初学者感知到的「魔法」。对这种「魔法」越是雾里看花就越难真正理解请求是如何进入应用、如何被处理、又如何变成 HTML 返回给浏览器的。RackRails 与 Sinatra 的共同基座关键线索在于Sinatra 和 Rails 一样都构建在 Rack 之上。Rack 是 Ruby 社区中连接 Web 服务器与应用代码的底层接口层。既然底层地基相同就可以把 Sinatra 理解为 Rails 的「裸版」bare bones versionRails为你生成完整的文件结构约定路由、控制器、视图、模型的摆放位置封装了大量中间件和基础设施Sinatra几乎没有「魔法」一切都很显式——你亲手写路由、亲手组织视图、亲手管理会话。这正是 sinatra.md 主张「先 Sinatra 后 Rails」的根本原因在 Sinatra 里亲手搭建一次路由和视图之后Rails 里那套看似复杂的文件结构与调用方法就会变得顺理成章。学习目标本课你要弄懂的三件事在开始动手之前先记住本课的学习目标Learning Outcomes完成练习后用它们自测什么是路由routesURL 与处理代码之间的映射关系决定「某个地址的请求由哪段代码响应」。什么是视图views负责把数据渲染成 HTML 呈现给用户的那一层。什么是 Sinatra 中的会话sessions如何在多个请求之间保存用户状态例如游戏进度、猜测次数以及如何使用它。这三者也是后续 project_sinatra.md 中两个实战项目Caesar Cipher 网页版、Web 游戏的核心依赖。第一个 Sinatra 应用frank_says.rb 从零跑通编写代码按官方首页的指引创建一个名为frank_says.rb的文件写入以下内容require sinatra get /frank-says do Put this in your pipe smoke it! end这段代码只有三行却完整地演示了 Sinatra 最核心的机制require sinatra引入 Sinatra 库并让后续的路由声明语法DSL领域特定语言生效get /frank-says do ... end声明一个GET 路由——当浏览器请求/frank-says这个地址时块内的代码被执行块的返回值Put this in your pipe smoke it!会被直接作为 HTTP 响应体返回给浏览器。对比 Rails 中处理一个 GET 请求需要「路由配置 → 控制器 action → 视图模板」的完整链路见 project_basic_rvc.md 中resources :users、UsersController#index、app/views/users/index.html.erb的逐步报错排查过程Sinatra 把「地址 → 响应」的映射压缩到了最小显式单元这就是「无魔法」的直观体现。安装并运行在命令行中执行gem install sinatra安装成功后运行刚才创建的文件ruby frank_says.rb然后打开浏览器访问http://localhost:4567/frank-says你会在页面上看到路由块中返回的那句话。默认端口是4567——这是 Sinatra 开发服务器的约定端口注意它与 Rails 默认的3000不同。在云开发环境Cloud9 等中运行如果你没有本地环境而是使用云端 IDE文档写作时以 Cloud9 为例同样的代码只需调整启动参数让服务器监听云端环境提供的 IP 与端口ruby frank_says.rb -o $IP -p $PORT其中-o指定监听地址$IP为环境变量-p指定监听端口$PORT为环境变量。启动后终端会给出访问链接你只需在浏览器地址栏追加/frank-says即可访问到该路由。深入理解三大核心概念路由RoutesURL 与代码的映射表路由是 Sinatra 的灵魂。get /frank-says do ... end的本质是「当收到一个针对路径/frank-says的 GET 请求时执行这个块」。Sinatra 支持多种 HTTP 动词get、post、put、delete等也支持在路径中使用动态参数例如/users/:id。你可以声明任意数量的路由每个路由块返回的内容就是响应体。理解这一点后再看 Rails 的config/routes.rb中一行resources :users就能瞬间生成 7 条 RESTful 路由对应 7 个控制器 action如index、show、create……你会意识到Rails 只是把 Sinatra 中你手写的那张「映射表」用约定帮你批量生成了而已。视图Views数据的呈现层在 Sinatra 中视图就是你自己组织的模板文件。路由块可以调用视图渲染例如配合 ERB 模板把数据注入 HTML。视图的职责边界与 Rails 一致控制器/路由负责逻辑与数据视图负责呈现。正因你在 Sinatra 里亲手决定视图文件放哪、如何渲染之后进入 Rails 看到app/views/...的固定目录约定时就不会再觉得那是凭空冒出来的规则。会话Sessions跨请求记住状态HTTP 是无状态的每个请求彼此独立。会话session机制通过在服务器端保存数据、在客户端通过 Cookie 携带会话标识让应用能「记住」用户。在 Sinatra 中使用会话通常需要启用会话支持如enable :sessions或在应用启动时配置 session 中间件在路由块中通过 session 哈希读写数据例如session[:guess_count]。project_sinatra.md 中特别提示做 Web 游戏Mastermind、Hangman时「你很可能需要再看一遍 Sinatra 中 sessions 的用法」——因为游戏状态已猜次数、当前单词、历史记录必须在多次请求之间持续存在这正是会话的典型应用场景。部署到 Heroku把应用送上公网project_sinatra.md 开篇给出了将 Sinatra 应用部署到 Heroku 的完整要点这是让应用「真正跑在互联网上」的必经环节步骤整理如下准备config.ru这个 Rack 入口文件需要require你的主应用文件例如 Jumpstart 教程里的web_guesser.rb。Rack 服务器启动时正是从config.ru加载应用。处理sinatra/reloader本地开发时常用sinatra/reloader实现代码改动自动重载。推送前必须移除或注释掉该行更优雅的做法是把它包在条件判断里if development? require sinatra/reloader end这样在 Heroku 的生产环境非 development 模式下它自动失效而本地开发照常生效。Gemfile 与依赖创建Gemfile声明依赖后执行bundle install生成并提交锁定文件。推送部署将文件提交到 git 后执行git push heroku master完成部署。这一套流程对 Rails 应用同样成立Rails 项目也有config.ru、Gemfile 与同样的部署管线先在小体量的 Sinatra 应用上跑通它能为你后续部署 Rails 应用建立完整的心智模型。实战项目把 Ruby 命令行程序变成 Web 应用项目一Caesar Cipher Reloaded凯撒密码网页版你已经在 Ruby 课程中实现过凯撒密码见 project_caesar_cipher.md其核心是「输入字符串与位移因子对每个字母做右移替换并保持大小写」。现在用 Sinatra 为它做一个简单前端新建一个 Sinatra 项目可以先从 Jumpstart 教程的 hello world 起步确认环境正常仅需一个视图加几条路由即可完成一个路由渲染表单视图另一个路由接收参数、调用你已有的加密逻辑并渲染结果用本文开头的部署步骤将应用部署到 Heroku。这个项目的价值在于「复用」把纯 Ruby 的算法代码与 Web 层解耦验证你已经能独立完成「接收请求 → 处理逻辑 → 渲染视图」的完整闭环。项目二另一个 Web 游戏Mastermind 或 Hangman从你在 Ruby 课程中完成的 Mastermind 或 Hangman 游戏中选择一个为它构建 Web 前端UI 实现完全由你决定保持纯文本可接受但既然上了 Web可以引入图片让界面更精致务必复习 Sinatra 中 sessions 的用法——游戏状态必须跨请求保存这是本项目成败的关键别忘了让朋友们都来玩你的游戏参考资源与进阶路径本课作业还要求阅读 Sinatra 官方 README 的前八个章节直到第 8 节 Helpers 为止——官方 README 几乎是 Sinatra 全部知识的浓缩适合作为实践过程中的参考手册。此外Jumpstart Lab 的 Web Guesser 教程一个数字猜谜游戏及其文末的 Extensions 扩展练习是与本课配套的经典动手材料文中也提到 Ruby Monstas 的 Sinatra 入门与会话专题可作为难度更温和的补充读物。值得留意的是sinatra.md 与 project_sinatra.md 目前存放于仓库的archive/old_lessons归档目录下。归档见 archive/README.md通常意味着内容被改写、替换或移出当前课程主线但这并不削弱其教学价值——作为「理解 Rails 内部机制」的预备材料先亲手写完一个无魔法的 Sinatra 应用再走进 Rails 的世界你将会对控制器、视图、路由、会话与部署有远超「照葫芦画瓢」的把握。【免费下载链接】curriculumThe open curriculum for learning web development项目地址: https://gitcode.com/GitHub_Trending/cu/curriculum创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考