开启Rails学习之旅：安装与使用指南

### 开启Rails学习之旅：安装与使用指南 #### 1. 学习Rails的整体规划 在开始学习Rails之前，我们需要做好一系列准备工作。首先要了解Ruby语言和Rails框架，并且完成它们的安装与验证。整个学习过程大致分为三个部分： - **第一部分：准备就绪**：介绍Ruby语言和Rails框架，完成Ruby和Rails的安装，并通过简单示例验证安装是否成功。 - **第二部分：通过实例理解概念**：以构建一个简单的在线商店为例，深入了解Rails背后的概念。这里不会逐个介绍Rails的每个组件，而是让你了解多个组件如何协同工作。如果你不想手动输入代码，还可以下载源代码。但要注意，如果直接从下载的文件中复制文件到应用程序中，若文件时间戳较旧，服务器可能无法识别更改。你可以使用MacOS或Linux上的`touch`命令更新时间戳，或者编辑文件并保存，也可以重启Rails服务器。 - **第三部分：深入探索Rails生态系统**：从熟悉的Rails功能和设施入手，介绍Rails框架所依赖的关键组件，以及一些流行的插件，这些插件使Rails成为一个开放的生态系统。 #### 2. 阅读代码的约定 在学习过程中，会遇到一些特定的约定： - **实时代码**：大多数代码片段来自完整的可运行示例，你可以下载。如果代码列表可以在下载文件中找到，代码片段前会有一个包含代码路径的条。如果你阅读的是电子书版本，且电子书阅读器支持超链接，点击该条代码会在浏览器窗口中显示。有些浏览器可能会误将HTML模板解释为HTML，此时查看页面源代码即可看到真实代码。在修改现有文件时，需要更改的行左侧可能会有小三角形提示。 ``` rails6/demo1/app/controllers/say_controller.rb class SayController < ApplicationController » def hello » end def goodbye end end ``` - **David说**：偶尔会出现“David说”的侧边栏，这里David Heinemeier Hansson会分享Rails特定方面的真实见解，包括原理、技巧和建议等。如果你想成为Rails专家，这些内容值得一读。 - **Joe问**：虚构的开发者Joe有时会提出关于文本中讨论内容的问题，我们会在学习过程中逐一解答。 #### 3. 学习资料说明 本书并非Rails的参考手册，因为参考手册并非大多数人学习的最佳方式。我们会通过示例或叙述的方式，在组件的使用和协作背景下展示大部分模块和方法。同时，书中也没有数百页的API列表，因为安装Rails时会自带这些文档，且保证比本书内容更及时更新。如果你使用RubyGems安装Rails（推荐方式），可以使用`gem server`命令启动gem文档服务器，然后在浏览器中访问`http://localhost:8808`查看所有Rails API。此外，Rails会明确指出发现的任何错误，并提供错误追踪信息。如果需要更多信息，可以查看相关错误处理部分。若遇到困难，网络上有很多资源可以提供帮助，你还可以在相关网站找到更多资源，包括论坛和勘误表，这些都是共享资源，你可以在论坛上提问、分享问题和建议。 #### 4. 安装Rails所需环境 要让Rails在你的系统上运行，需要以下环境： - **Ruby解释器**：Rails用Ruby编写，你的应用程序也将使用Ruby编写。Rails 6可在Ruby 2.5和2.6版本上运行，不支持更早版本。 - **Ruby on Rails**：本书使用Rails 6.0.1版本编写。 - **JavaScript解释器**：Microsoft Windows和macOS自带JavaScript解释器，Rails会使用系统自带版本。其他操作系统可能需要单独安装。 - **一些库**：具体取决于操作系统。 - **数据库**：本书使用SQLite 3。 - **额外工具**：为了运行和调试一些高级JavaScript部分，需要安装Yarn（JavaScript包管理器）和ChromeDriver（用于Web应用程序自动化测试的工具）。 对于开发机器，除了上述内容，还需要一个编辑器。如果要部署应用程序，还需要安装生产Web服务器和一些支持代码，以确保Rails高效运行。你也可以在虚拟机中安装所有内容，这样可以将Rails环境与实际计算机隔离，但需要一定的磁盘空间。 #### 5. 不同操作系统的安装步骤 安装方式取决于你的开发环境，下面介绍三种常见选择：Windows、macOS和Ubuntu Linux。 ##### 5.1 在Windows上安装 - **安装Ruby**：使用RubyInstaller for Windows包安装Ruby。目前最新版本是Ruby 2.6.0。安装分为两步，先安装基础语言，再安装开发工具包。基础安装很简单，点击保存/下载后，依次点击运行、确定，接受许可协议，选择“将Ruby可执行文件添加到PATH”，然后点击安装和完成。下载并解压Ruby 2.0及更高版本的开发工具包，将解压目标覆盖为`C:\ruby\devkit`。完成后，在开始菜单中找到“Start Command Prompt with Ruby”并启动，在窗口中输入以下命令： ``` > cd \ruby\devkit > ruby dk.rb init > ruby dk.rb install ``` - **安装Node.js**：推荐安装LTS版本。点击保存/下载后，依次点击运行、下一步，接受许可协议，再点击三次下一步，然后点击安装。若提示允许安装，点击是，最后点击完成。 - **安装Git（可选但推荐）**：Git在Ruby和Rails生态系统中广泛使用，熟悉它有助于与一些高级工具和技术交互。点击保存/下载后，点击运行，若提示允许安装，点击是，点击下一步，阅读许可协议，再点击四次下一步，选择“从Windows命令提示符使用Git”，然后再点击五次下一步，点击完成，最后查看并关闭发行说明窗口。 - **安装Yarn**：推荐使用安装程序版本。点击保存/下载后，依次点击运行、下一步，接受许可协议，再点击两次下一步，然后点击安装。若提示允许安装，点击是，最后点击完成。 - **安装ChromeDriver**：点击最新版本（目前是ChromeDriver 2.29），下载`win32.zip`文件。下载完成后，点击打开，右键点击“chromedriver”并选择复制。双击“此电脑”，依次双击`C:\`、`Windows`，在该窗口内右键点击并选择粘贴，点击继续。 - **验证安装**：打开命令窗口，输入以下命令验证Ruby、Node和Git是否安装正确： ``` > ruby -v > node -v > git --version ``` - **配置Git**：根据需要调整用户名和邮箱： ``` > git config --global user.name "John Doe" > git config --global user.email [email protected] ``` - **安装Rails**：使用以下命令安装Rails： ``` > gem install rails --version=6.0.1 --no-document ``` 安装完成后，确保安装的Rails版本与本书描述的版本一致。 ##### 5.2 在macOS上安装 - **检查Ruby版本**：如果使用的是macOS Catalina，系统自带Ruby 2.6.3，可以直接跳到安装Rails的步骤。如果是旧版本的macOS，需要下载与Rails 6兼容的新版本Ruby，最简单的方法是使用Homebrew。在开始前，将终端应用程序拖到 Dock 上，打开终端并运行以下命令： ``` > ruby -e "$(curl -fsSL \ https://raw.githubusercontent.com/Homebrew/install/master/install)" ``` 当提示安装Xcode命令行工具时，选择是。 - **更新Ruby版本**：有两种选择。一种是让Homebrew将Ruby版本更新到最新（目前是Ruby 2.6.5），使用命令`$ brew install ruby`；另一种是安装rbenv并在系统Ruby旁边安装并行版本的Ruby。安装rbenv的步骤如下： ``` $ brew install rbenv ruby-build $ rbenv init $ echo 'eval "$(rbenv init -)"' >> ~/.zshrc $ rehash ``` 如果使用的是旧版本的macOS或在Catalina上使用bash，步骤类似： ``` $ brew install rbenv ruby-build $ echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bash_profile $ ~/.rbenv/bin/rbenv init $ hash -r ``` 完成后，重启终端，然后安装Ruby 2.6.5： ``` $ rbenv install 2.6.5 $ rbenv global 2.6.5 ``` 如果之前安装过`ruby-build`但找不到Ruby 2.6.5的定义，可能需要重新安装： ``` $ brew reinstall --HEAD ruby-build $ rbenv install 2.6.5 $ rbenv global 2.6.5 ``` 运行`$ ruby -v`命令，应该能看到输出中包含2.6.5。 - **安装Rails**：使用以下命令更新Rails到本书使用的版本： ``` $ gem install rails --version=6.0.1 --no-document ``` - **安装Yarn和ChromeDriver**： ``` $ brew install yarn $ brew tap homebrew/cask $ brew cask install chromedriver ``` ##### 5.3 在Linux上安装 由于Linux有多种不同的发行版，安装方法各异，这里以在运行Ubuntu Linux的虚拟机中设置Rails环境为例。 - **设置虚拟机**：使用Vagrant管理虚拟计算机，Virtual Box提供虚拟计算机，它们一起可以提供一个干净、可预测且与实际计算机隔离的环境。首先需要安装Vagrant和Virtual Box，具体安装方法根据操作系统而定，可参考它们的官方安装说明。安装完成后，创建一个名为`Vagrantfile`的文件，内容如下： ``` # We want to use version '2' of Vagrant's configuration language Vagrant.configure("2") do |config| # This is the operating system to use, in this case # Ubuntu Linux config.vm.box = "ubuntu/trusty64" # This is configuration specifically for the virtual # machine, and this gives it 4G of memory config.vm.provider "virtualbox" do |vb| vb.memory = "4096" end # When Rails runs on port 3000 inside your virtual machine, this # allows you to access it from a browser on your machine by # going to port 3000 on your machine. config.vm.network "forwarded_port", guest: 3000, host: 3000 # This will mount your current directory on your computer # to the directory /files_on_your_computer inside the virtual machine config.vm.synced_folder ".", "/files_on_your_computer" end ``` 打开命令行窗口，切换到创建该文件的目录，运行`$ vagrant up`命令启动虚拟机。首次运行该命令需要一些时间，因为它需要下载和安装整个操作系统。完成后，使用`$ vagrant ssh`命令登录虚拟机。 - **安装系统软件**：如果使用虚拟机，后续命令假设你已通过`vagrant ssh`登录。如果没有使用虚拟机，假设你以可以执行`sudo`的用户身份登录。首先刷新操作系统可用软件包列表： ``` $ sudo apt-get update ``` 然后安装多个库和工具： ``` $ sudo apt-get install -y autoconf \ bison \ build-essential \ curl \ g++ \ gcc \ git \ libffi-dev \ libgconf-2-4 \ libgdbm-dev \ libncurses5-dev \ libreadline-dev \ libreadline-dev \ libsqlite3-dev \ libssl-dev \ libxi6 \ libyaml-dev \ make \ sqlite3 \ xvfb \ zip \ zlib1g-dev ``` 接着安装NodeJS： ``` $ curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash - $ sudo apt-get install -y nodejs ``` 运行`node --version`验证安装是否成功，应该看到版本号为12.x.y。最后安装Yarn： ``` $ curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add - $ echo "deb https://dl.yarnpkg.com/debian/ stable main" | \ sudo tee /etc/apt/sources.list.d/yarn.list $ sudo apt update && sudo apt install -y yarn ``` 运行`yarn --version`验证安装是否成功，版本号应为1.19或更高。 - **安装Ruby和Rails**：系统可能已安装Ruby，但可能不是运行Rails所需的版本，这里使用rbenv在系统Ruby旁边安装并行版本的Ruby。首先安装rbenv： ``` $ curl -sL \ https://github.com/rbenv/rbenv-installer/raw/master/bin/rbenv-installer \ | bash - ``` 调整shell设置，将rbenv管理的Ruby添加到路径： ``` $ echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc $ echo 'eval "$(rbenv init -)"' >> ~/.bashrc $ source ~/.bashrc ``` 安装Ruby 2.6.5： ``` $ rbenv install 2.6.5 $ rbenv global 2.6.5 ``` 运行`ruby -v`验证安装是否成功，输出应包含2.6.5。然后安装Rails： ``` $ gem install rails --version=6.0.1 --no-document ``` 运行`rails --version`验证安装是否成功，输出应包含6.0.1。 - **安装ChromeDriver**：首先安装Chrome： ``` $ sudo curl -sS -o - \ https://dl-ssl.google.com/linux/linux_signing_key.pub \ | sudo apt-key add - $ sudo echo \ "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" \ | sudo tee /etc/apt/sources.list.d/google-chrome.list $ sudo apt-get -y update $ sudo apt-get -y install google-chrome-stable ``` 然后下载、解压并复制ChromeDriver二进制文件到路径： ``` $ wget https://chromedriver.storage.googleapis.com/2.41/chromedriver_linux64.zip $ unzip chromedriver_linux64.zip $ sudo mv chromedriver /usr/bin/chromedriver $ sudo chown root:root /usr/bin/chromedriver $ sudo chmod +x /usr/bin/chromedriver ``` 通过以上步骤，你就可以在不同操作系统上完成Rails的安装，开启Rails学习之旅。在学习过程中，遇到问题可以参考相关文档和在线资源，也可以在论坛上与其他学习者交流。 ### 开启Rails学习之旅：安装与使用指南 #### 6. 安装步骤总结与对比 为了更清晰地了解不同操作系统下的安装步骤，我们将其总结成表格形式： | 操作系统 | Ruby安装 | Node.js安装 | Git安装 | Yarn安装 | ChromeDriver安装 | Rails安装 | | --- | --- | --- | --- | --- | --- | --- | | Windows | 使用RubyInstaller for Windows，分基础语言和开发工具包两步安装 | 下载LTS版本安装 | 可选但推荐，按常规步骤安装 | 用安装程序版本安装 | 下载win32.zip文件并复制到指定位置 | `gem install rails --version=6.0.1 --no-document` | | macOS | Catalina自带Ruby 2.6.3可跳过，旧版本用Homebrew或rbenv更新 | 无特殊说明 | 无特殊说明 | `brew install yarn` | `brew cask install chromedriver` | `gem install rails --version=6.0.1 --no-document` | | Linux（Ubuntu虚拟机） | 用rbenv在系统Ruby旁安装并行版本 | 用脚本安装 | 安装系统软件时一并安装 | 用脚本安装 | 先安装Chrome再下载解压复制二进制文件 | `gem install rails --version=6.0.1 --no-document` | 下面是安装流程的mermaid格式流程图： ```mermaid graph LR classDef startend fill:#F5EBFF,stroke:#BE8FED,stroke-width:2px classDef process fill:#E5F6FF,stroke:#73A6FF,stroke-width:2px classDef decision fill:#FFF6CC,stroke:#FFBC52,stroke-width:2px A([开始]):::startend --> B{选择操作系统}:::decision B -->|Windows| C(安装Ruby):::process B -->|macOS| D(检查Ruby版本):::process B -->|Linux| E(设置虚拟机):::process C --> F(安装Node.js):::process C --> G(安装Git):::process C --> H(安装Yarn):::process C --> I(安装ChromeDriver):::process C --> J(安装Rails):::process D -->|需要更新| K(用Homebrew或rbenv更新Ruby):::process D -->|无需更新| L(安装Rails):::process K --> L E --> M(安装系统软件):::process M --> N(安装Ruby和Rails):::process N --> O(安装ChromeDriver):::process F --> J G --> J H --> J I --> J L --> P([完成]):::startend J --> P O --> P ``` #### 7. 安装过程中的注意事项 - **文件时间戳问题**：在第二部分学习中，如果直接从下载的文件中复制文件到应用程序中，要注意文件时间戳。若时间戳较旧，服务器可能无法识别更改。可以使用MacOS或Linux上的`touch`命令更新时间戳，或者编辑文件并保存，也可以重启Rails服务器。 - **软件兼容性**： - Rails 6只能在Ruby 2.5和2.6版本上运行，安装时要确保Ruby版本符合要求。 - 在macOS上使用rbenv时，要确保没有安装RVM，因为两者不能很好地协同工作。 - **权限问题**：在Linux系统中，很多安装命令需要使用`sudo`以获取足够的权限。在执行这些命令时，要确保你有相应的权限，并且谨慎操作，避免对系统造成不必要的影响。 #### 8. 后续学习建议 - **构建示例项目**：完成安装后，可以按照第二部分的内容，构建一个简单的在线商店示例项目。通过实际操作，深入理解Rails背后的概念，了解多个组件如何协同工作。在构建过程中，要注意代码的编写规范和逻辑，遇到问题可以参考代码中的注释和相关说明。 - **深入学习Rails生态系统**：在熟悉了基本的Rails使用后，可以进入第三部分的学习，深入探索Rails生态系统。了解Rails框架所依赖的关键组件和流行的插件，这些知识将有助于你构建更复杂、更强大的应用程序。 - **利用在线资源**：学习过程中难免会遇到问题，网络上有很多关于Rails的学习资源，如官方文档、论坛、博客等。可以充分利用这些资源，解决遇到的问题，同时也可以学习他人的经验和技巧。例如，在相关网站上可以找到更多的学习资料，包括论坛和勘误表，你可以在论坛上提问、分享问题和建议，与其他学习者交流。 #### 9. 总结 通过本文，我们详细介绍了学习Rails的整体规划、阅读代码的约定、学习资料说明、安装Rails所需的环境以及不同操作系统下的安装步骤。在安装过程中，要根据自己的操作系统选择合适的安装方法，并注意安装过程中的注意事项。完成安装后，要通过实际项目的练习和深入学习Rails生态系统，不断提升自己的Rails开发能力。希望本文能帮助你顺利开启Rails学习之旅，在Rails开发的道路上取得更好的成绩。 在学习过程中，要保持耐心和积极的学习态度，遇到问题不要轻易放弃。相信通过不断的学习和实践，你一定能够掌握Rails开发技术，开发出优秀的应用程序。