企业官网建设流程全解析

• 教程
• 后端

本文以 Rails Girls 系列指南中的《Basic Web Application》（对应仓库文档 _pages/touristic-autism_basic-app.md）为主体，面向 Rails Girls 工作坊参与者与初次接触 Ruby on Rails 的开发者，完整讲解如何从零创建一个名为railsgirls-galway-2014的新 Rails 应用、启动本地开发服务器并验证安装是否成功。读完本文，你将掌握跨平台（macOS / Windows / Linux）的终端操作差异、rails new生成的应用骨架结构，以及 Model-View-Controller（MVC）架构为何是理解后续一切 Rails 开发的基础。

背景：这篇指南在 Touristic Autism 教程系列中的位置

这篇《Basic Web Application》是《Rails Girls Touristic Autism-friendly Spots App Tutorial》系列教程（仓库文档 _pages/touristic-autism_intro.md）中的第 1 步。整个系列的目标是构建一个"自闭症友好旅游景点"应用，帮助自闭症成年人在旅行中描述、展示、评论旅游景点，并对其"自闭症友好程度"进行评分——该应用需求由 Galway Autism Partnership 提出。

系列共 8 步，本篇是第一步，也是后续所有步骤的地基：

1. 基础 Web 应用（本篇，rails new创建应用）
2. 版本控制与 Git
3. 资源建模（user / place / comment 三大资源及关联）
4. 资源评分（letsrate 星评）
5. 设计美化（Bootstrap）
6. 图片上传与缩略图 7.（进阶）持续部署 8.（进阶）持续测试与集成

本篇合并、改编自 Rails Girls 基础 app 指南 以及 Ruby on Rails Tutorial 中"创建应用"的章节，因此它与标准 Rails Girls 工作坊的第一课内容一脉相承。

前置条件与重要提示

开始之前，请确认你的电脑上已经安装好Rails 与 Git。若尚未安装，请先阅读仓库中的 安装指南（该指南分别覆盖 macOS、Windows、Linux 与 Replit 等安装路径）。

重要提示：必须根据你的操作系统选择对应的指令——Windows 上需要运行的命令与 Mac 或 Linux 略有不同。本文所有命令块都会同时给出两种版本，请留意切换。

第 1 步：打开终端

终端（Terminal）是执行命令行操作的地方，不同系统的打开方式如下：

第 2 步：创建应用railsgirls-galway-2014

我们将在终端中依次执行下面的命令，创建一个名为railsgirls-galway-2014的新 Rails 应用：

macOS / Linux 版本

mkdir projects cd projects rails new railsgirls-galway-2014 rvm rubygems latest cd railsgirls-galway-2014 rails server

Windows 版本

mkdir projects cd projects rails new railsgirls-galway-2014 cd railsgirls rails server

每条命令的执行目的与验证方法如下：

1. mkdir projects：创建一个名为projects的目录（文件夹）。
   • mkdir是makedirectory（创建目录）的缩写。
   • macOS/Linux 下用ls验证：输出中应能看到projects目录；Windows 下改用dir命令。
2. cd projects：进入刚才创建的projects目录。
   • cd是changedirectory（切换目录）的缩写。
   • 再次运行ls（或dir）确认当前处于空目录中。
3. rails new railsgirls-galway-2014：在工作目录中创建一个全新的 Ruby on Rails 应用。
   • 该命令会自动生成包含app、config等众多子目录的完整应用骨架。
   • 注意命令的目录名与实际应用名要保持一致，后续cd进入的是同一个名字。
4. rvm rubygems latest（仅 macOS/Linux 版本）：通过 RVM 将 RubyGems 更新到最新版本，避免 gem 依赖解析出现问题。
5. cd railsgirls-galway-2014：进入 Rails 应用目录。此时运行ls（或dir）应能看到app、config等文件夹。
6. rails server：在本地启动 Rails 开发服务器。

验证应用是否创建成功

保持服务器运行，在浏览器中打开 http://localhost:3000。如果看到"Welcome aboard"（Rails 欢迎页），说明应用生成成功。

关于 localhost：它特指你自己的电脑（"本地主机"），开发服务器从这里启动。localhost 让开发者能在开发阶段直接在浏览器中查看和测试应用，无需部署到公网。打开 http://localhost:3000 时，地址栏中应能看到localhost:3000。

如果你使用的是云端环境（例如 Replit），则改用其预览功能查看页面，具体参见 Replit 安装指南。

理解终端中的命令提示符变化

启动rails server之后，你会发现命令提示符消失了——因为当前终端窗口正在被 Rails 服务器占用：

• macOS / Linux 下的正常提示符形如$；
• Windows 下的正常提示符形如>。

当提示符不可见时，你无法执行新的命令。此时如果强行输入cd或其他命令，不会有任何反应。要退出服务器并恢复正常提示符，请在终端中按下：

Ctrl+C

这是 Rails 开发中最常用的一个组合键，用于终止当前正在前台运行的进程。

深入理解：这几条命令到底做了什么

Rails Girls 系列的配套文档 Guide to the Guide 对上述命令做了逐条拆解，是理解本步骤原理的最佳参考：

• mkdir projects—— 在当前目录（通常是你的主目录）创建一个叫projects的文件夹。
• cd projects—— 导航到刚创建的projects文件夹。
• rails new railsgirls-galway-2014—— 创建名为railsgirls-galway-2014的 Ruby on Rails 应用，自动生成大量标准文件夹与文件。
• rails server—— 在电脑上启动一个本地 Web 服务器，通过 http://localhost:3000 访问。

这里值得注意：rails new一次性生成的文件远不止app和config两个目录。完整骨架还包括模型/控制器/视图三层目录、路由配置、数据库迁移目录、Gemfile、测试目录等——这些正是下一步工作中要反复打交道的核心文件。

从源码看：rails new生成的是 MVC 骨架

《Basic Web Application》文档在末尾点明了一个关键概念：

由rails new生成的骨架体现了Model-View-Controller（MVC）架构模式。

结合 Guide to the Guide 的 MVC 章节可以更完整地理解这一点：

• 标准 Rails 应用的app/目录下，一开始就有三个关键子目录：models、controllers和views；
• 模型（Model）代表应用中的资源定义（如用户、想法、评论），并负责与数据库通信；
• 控制器（Controller）充当模型与视图之间的"中介"，接收浏览器请求、调用模型取数、再渲染视图；
• 视图（View）由 HTML 与内嵌 Ruby（ERB）组成，最终生成返回给浏览器的页面。

当浏览器请求一个页面时，完整链路是：浏览器 → 服务器 → 控制器 → 模型 → 数据库 → 模型返回数据 → 控制器渲染视图 → HTML 返回浏览器。理解了这条链路，后续在本系列中创建place、comment资源时，你就能清楚地知道每个文件的作用。

教练提示：本篇的教学要点

本仓库中的文档采用 Jekyll 构建（见 Gemfile），并通过{% coach %}标签为教练提供专属提示。该标签由仓库中的 Liquid 插件 _plugins/coach.rb 实现——内容会以 Markdown 转换后渲染进一个带 "Help from the coach" 标题的提示框中。本页的教练要点是：

• 解释每一条命令的作用（mkdir、cd、rails new、rails server）；
• 解释rails new生成了什么；
• 解释rails server为什么必要、以及如何停止服务器。

这些要点与 Guide to the Guide 第 1 节"Create the application"的内容完全对应，工作坊参与者可以对照复习。

操作系统差异速查表

为方便对照，将本步骤所有命令按系统整理如下：

注意：原始文档中 Windows 分支存在一处命名不一致（命令提示中应用名为railsgirls-galway-2014，但cd时写为railsgirls）。实操时请务必统一——用哪个名字创建应用，就用哪个名字进入目录，否则会因目录不存在而报错。

常见问题与排错

Q：打开 http://localhost:3000 报错或页面打不开？A：确认rails server仍在运行（终端没有回到提示符状态），且没有别的进程占用 3000 端口。可先Ctrl+C停止服务器后重新rails server启动。

Q：提示 JavaScript / CoffeeScript 相关错误？A：如果终端出现疑似 JavaScript 或 CoffeeScript 的报错，通常是系统缺少 Node.js 运行时（常见于用gem install rails方式安装 Rails 的场景）。安装 nodejs 即可解决；若使用 RailsInstaller 安装则一般不会遇到此问题。

Q：如何确认自己当前在哪个目录？A：macOS/Linux 用pwd（print working directory）查看当前路径；Windows 用cd（不带参数）查看。养成"先确认路径再执行命令"的习惯，能避免在错误目录下创建应用。

接下来做什么

至此，你已经拥有了一个可运行的基础 Rails 应用。按照系列教程的路线，下一步是：

• 第 2 步：用 Git 做版本控制——初始化仓库、提交并推送到远程；
• 第 3 步：资源建模——为应用添加用户认证（devise）、景点（place）与评论（comment）资源；
• 后续的评分、设计、图片上传与部署步骤详见系列索引 _pages/touristic-autism_intro.md。

如果对"创建应用"这一步还有疑问，请在工作坊中随时向教练提问，或者阅读 Guide to the Guide 中对应的概念讲解。基础打牢了，后面的每一步都会水到渠成。

• 教程
• 后端