---
# System prepended metadata

title: 在macOS上建立Ruby-on-Rails環境

---

# 在macOS上建立Ruby-on-Rails環境
## 前情提要
最近因為暑假想要研究一下Ruby-on-Rails，打算照著[Rails 起步走](https://rails.ruby.tw/getting_started.html)的腳步來寫一個部落格，未來也可以用來放些學習筆記。
因為之前在windows桌機上建立環境時沒遇到那麼多問題，macbook上倒是遇到了一些，後來發現是因為沒有正確操作所造成，所以想說紀錄一下。

## 安裝rbenv
rbenv可以用來安裝和管理電腦上的ruby版本
> 快用萬能的brew想想辦法
```
brew install rbenv
```
裝完之後先執行
```
rbenv init
```
![](https://i.imgur.com/NSNag6H.png)
要去zsh的設定檔加入eval "$(rbenv init -)"，在終端機輸入
```
echo 'eval "$(rbenv init -)"' >> ~/.zshrc
```
確認一下有沒有加進去
```
grep rbenv ~/.zshrc
```
![](https://i.imgur.com/Tu4pd4J.png)
p.s. 我是直接vim進去改所以加了一點註解

```
curl -fsSL https://github.com/rbenv/rbenv-installer/raw/main/bin/rbenv-doctor | bash
```
![](https://i.imgur.com/dqNIrCh.png)

## 安裝Ruby
先看看可以裝哪些版本
```
rbenv install -l
```
![](https://i.imgur.com/8rd0JPW.png)
直接熱血開裝最新版

裝完之後就要來選版本了
有三種方法 執行的優先權不同（這邊排序由低到高）
詳情參考[這篇](https://gist.github.com/sandyxu/8aceec7e436a6ab9621f)
```
rbenv global 3.0.2
```
```
rbenv local 3.0.2
```
```
rbenv shell 3.0.2
```

最後重開一下終端機看一下有沒有成功
```
ruby -v
```
也試一下gem有沒有一起被安裝
```
gem -v
```
![](https://i.imgur.com/eq5wnxd.png)
好耶都沒出事

## 安裝Rails
用剛剛說的gem安裝
```
gem install rails
```

確認看看有沒有成功
```
rails -v
```
![](https://i.imgur.com/JYVGQps.png)


## 建立Rails專案
到喜歡的地方創建一個資料夾然後cd過去
並在終端機輸入
```
rails new {專案名稱}
```
創建的時候可能會叫你去安裝[node.js](https://nodejs.org/en/download/)和[yarn](https://classic.yarnpkg.com/en/docs/install/#mac-stable)
都安裝完成再執行一次就可以成功創建專案了

使用Rails內建的測試伺服器實驗看看
先cd進剛剛創的專案，然後打
```
bin/rails server
```
![](https://i.imgur.com/O7BZwmH.png)
照上面說的我們可以去127.0.0.1:3000，就會看到這張測試頁
![](https://i.imgur.com/7oyLoAX.jpg)
按下Ctrl + C就可以關閉測試用的伺服器

## 總結
安裝過程中我遇到最大的問題是rbenv init的時候，我以為只要去設定PATH就可以了，所以我在~/.zshrc加入了錯誤的東西，導致後面安裝的東西都出了問題。
能夠找到這個問題是因為我將環境從頭到尾重新安裝過，並且檢視每一步的錯誤，發現在GitHub上面有人有[一樣的問題](https://github.com/rbenv/rbenv/issues/815)才因此解決。
之後遇到值得紀錄的東西我應該也會寫篇筆記來紀錄