本文将提供一套最佳实践流,来帮助你告别 macOS 裸机配置开发环境时的各种坑,告别痛苦,一发入魂
前文
在经历了一个月内连续为两台全新 MBP 配置开发环境的痛苦过后,终于不胜其扰,遂决定写一篇可以一次 AC 的配置流程,从此告别 macOS 系统裸机配置环境的各种坑。作者打包票,完全按照本文的顺序操作,可以保证你顺利的一次配置完成基本的开发环境。
本文初稿时的操作系统为 macOS Catalina 10.15.7,不排除后续本教程的更新
最佳实践
步骤1 下载 & 安装Xcode
当你拿到一台全新的 mac 裸机时,你要做的第一件事情,就是打开 AppStore 然后去下载 Xcode,因为它几乎集成了你所需要的所有最基本的开发工具链,无论你需要配置什么样的开发环境,几乎都绕不过 Xcode。
步骤2 安装必备应用
下载 Xcode 的过程通常很漫长,光是 Xcode12 就已经达到恐怖的 11.7 G了。所以这个时候,我们可以去下载安装一些必备应用(建议按照顺序安装):
Chrome 浏览器
想不为什么还会有工程师选择不用 Chrome 🤔。下载地址
iTerm2
macOS 上最好用的命令行工具,没有之一!下载地址
SwitchHosts
快速编辑 host 的工具,尤其对于国内的工程师,通过调整 host 能够帮你避免大多数因为墙而导致的类似 curl: (7) Failed to connect to raw.githubusercontent.com port 443: Connection refused 的网络连接问题。下载地址](https://github.com/oldj/SwitchHosts/releases)
V2RayU
开源(现已删除 github 源码,但仍提供 dmg下载)的基于 V2Ray 协议的梯子,SSR已经非常不安全了,如果你用的还是 SSR,建议你立刻使用 V2Ray,至于为什么?感兴趣的同学自行了解,自己看别问,如果你不想安装这个,只要保证你有稳定的梯子即可,不做强制要求。下载地址
搜狗输入法
macOS 自带的输入法之难用,用过的都懂,作者推荐搜狗,如果你有自己习惯的输入法,可以自行安装。下载地址
其他
以上罗列的应用是必备的(头铁的出了问题不要来找我),至于其他个人喜好的应用、办公软件,请自行下载,这里不再罗列。
步骤3 安装初始化 Xcode
Xcode 下载完成后,进行初始化安装,必须安装完成才可以进行下一步操作。
步骤4 修改 Hosts
打开上一步中安装好的 SwitchHosts,选择左边菜单栏的 My Hosts,然后在右边 # My hosts
下方的空白处输入以下内容
1 | 199.232.68.133 raw.githubusercontent.com |
步骤5 安装 Oh-my-zsh
Oh-my-zsh 是一个必备的命令行高亮插件,打开 iTerm2 输入命令进行安装(从这一步开始,请全程保证梯子的开启状态)
1 | sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" |
步骤6 安装 Homebrew
不要头铁,不要迷信你的梯子可以顺利下载,不想来回折腾就老老实实操作。
1.复制下面 url 到浏览器
1 | https://raw.githubusercontent.com/Homebrew/install/master/install.sh |
2.保存网页的脚本内容到本地 brew_install.sh
3.打开 iTerm2 至脚本目录执行
1 | bash brew_install.sh |
等待安装完成即可
步骤7 安装 RVM
安装命令
1 | curl -L https://get.rvm.io | bash -s stable |
安装完成之后,记得按照提示初始化 rvm,否则会提示找不到 rvm。
步骤8 安装并初始化 Ruby
1.查找可安装的 Ruby 版本
1 | rvm list known |
2.找到列出的可安装版本进行安装。
这个过程比较长,头铁并且对自己网络自信的同学可以耐心等待,不想出问题来回折腾的请自觉关闭 wifi 连上手机热点,保证网路的稳定。不过头铁的同学大概率会收到Requirements installation failed with status:1
大礼包,请默默换到手机热点。
1 | rvm install ruby-3.0.0 # 可以简写为 rvm install 3.0.0 |
3.查看安装完成的 Ruby 版本
1 | ruby -v |
显示刚才安装的版本则说明已安装完成。
4.将安装完成的 Ruby 版本设为默认版本
1 | rvm ruby use ruby-3.0.0 |
1 | rvm --default use 3.0.0 |
步骤9 安装 Node
1.输入下面的命令进行安装
1 | brew install node |
2.完成后验证下版本即可
1 | node -v |
出现刚才安装的版本即可。
安装 CocoaPods
基础环境到上一步基本就结束了,到这里就是 iOS 同学的专场了,其他同学可以去自行安装自己的其他具体环境了。
安装 cocoaPods(全程保持手机热点)
1 | brew install cocoapods # 默认安装最新pods |
如果需要指定版本(首次安装不推荐,头铁的同学自便)
1 | sudo gem install -n /usr/local/bin cocoapods -v 1.10.1 |
项目初始化
如果项目使用了基于pod的私有库,需要提前添加私有库
1 | pod repo add xxx xxx.git # xxx是pod名称,xxx.git是私有库地址 |
进入项目根目录,初始化项目pods
1 | pod install |
最后
至此,这套 macOS 新设备配置开发环境的最佳实践流就结束了,完全按照操作你基本不会遇到任何障碍,各位同学一定不要头铁啊。