Mac开发环境配置看这一篇就够了

从 macOS Catalina 开始，Mac 使用 zsh 作为默认登录 Shell 和交互式 Shell。当然你也可以修改默认Shell，但一般没这个必要。而实际开发中经常会遇到一些环境问题导致的报错，下面我们就讲一下一些常用库的环境配置以及原理。

作为Mac上最常用的包管理器，Homebrew可以称为神器，用它来管理Mac上的依赖环境便捷又省心。

直接在终端执行一键脚本即可

/// 安装
brew install FORMULA|CASK...

/// 搜索
brew search TEXT|/REGEX/

/// 卸载包
brew uninstall FORMULA|CASK...

/// 查看安装列表
brew list [FORMULA|CASK...]

/// 查看包信息
brew info [FORMULA|CASK...]

/// 查看哪些包可以更新
brew outdated 

/// 更新指定包（安装新包，但旧包依旧保留）
brew upgrade [FORMULA|CASK...]

/// 更新Homebrew
brew update                  

/// 清理旧版本和缓存
brew cleanup       					# 清理所有包的旧版本
brew cleanup [FORMULA ...]  # 清理指定包的旧版本
brew cleanup -n             # 查看可清理的旧版本包，不执行实际操作

/// 锁定不想更新的包（因为update会一次更新所有的包的，当我们想忽略的时候可以使用这个命令）
brew pin [FORMULA ...]      # 锁定某个包
brew unpin [FORMULA ...]    # 取消锁定

/// 软件服务管理
brew services list  								# 查看使用brew安装的服务列表
brew services run formula|--all  		# 启动服务（仅启动不注册）
brew services start formula|--all  	# 启动服务，并注册
brew services stop formula|--all   	# 停止服务，并取消注册
brew services restart formula|--all # 重启服务，并注册

其实Mac系统默认已经有Ruby的环境了，在终端中执行ruby -v查看版本号。

~:~$ruby -v
ruby 2.6.3p62 (2019-04-16 revision 67580) [universal.x86_64-darwin20]

本地ruby版本有点低了，这里我们使用Homebrew来更新，

brew install ruby

执行结束后默认会将最新版本的ruby安装到/usr/local/Cellar/目录下。

我们查看一下当前的ruby版本：

~:~$ruby -v
ruby 2.6.3p62 (2019-04-16 revision 67580) [universal.x86_64-darwin20]

好像版本并未发生变化，why？ 这里主要是因为Shell环境中并没有读到最新的ruby路径，我们可以再编辑一下用户目录下的环境配置文件~/.zshrc，新增ruby的路径并写入环境变量：

# 环境变量配置
export RUBY=/usr/local/Cellar/ruby/3.2.0/bin
export GEMS=/usr/local/lib/ruby/gems/3.2.0/bin

# 写入环境变量
export PATH=$RUBY:$GEMS:$PATH

这里先添加上面的内容然后执行source ~/.zshrc，后面会讲到Shell环境配置相关的内容。

再次查看ruby版本：

~:~$ruby -v
ruby 3.2.0 (2022-12-25 revision a528908271) [x86_64-darwin20]

此时可以看到ruby已经升级到最新的3.2.0版本。

当然我们还可以执行which ruby查看当前的ruby的具体路径：

~:~$which ruby
/usr/local/Cellar/ruby/3.2.0/bin/ruby

从结果可以看出当前使用的ruby正是我们在.zshrc中配置的路径。

Gem是ruby的包管理器，一些ruby库我们需要使用Gem来安装，但Gem官方源速度拉胯，这里我们需要替换为国内源。

/// 添加国内源并删除官方源
gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/

/// 查看当前源地址
gem sources -l

查看当前源，确认已替换为国内源即可。

~:~$gem sources -l
*** CURRENT SOURCES ***

https://gems.ruby-china.com/

/// cocoapods安装
gem install cocoapods

/// fastlane安装
gem install fastlane

耐心等待安装完成后我们可以测试一下：

~:~$pod --version
1.11.3

~:~$fastlane --version
fastlane installation at path:
/usr/local/lib/ruby/gems/3.2.0/gems/fastlane-2.211.0/bin/fastlane
-----------------------------
[✔] 🚀
fastlane 2.211.0

从结果可以看出cocoapods和fastlane都安装完成了。

其实Xcode命令行工具自带了python库，项目中需要执行python脚本的优先使用这个会更合适，因为Xcode编译项目时会优先使用这个python库，Mac中仅使用这一个版本可以避免一些多python版本环境问题导致的报错。

根据当前Xcode命令行工具中的python版本，这里我们需要在~/.zshrc中添加相关配置并执行source ~/.zshrc重载配置：

# 环境变量配置
export PYTHON=/Library/Developer/CommandLineTools/Library/Frameworks/Python3.framework/Versions/3.8/Python3/bin

# 写入环境变量
export PATH=$PYTHON:$PATH

# 别名
alias python=python3
alias pip=pip3

这里使用别名以便于执行python命令时使用的是python3， 查看一下版本，结果也符合预期。

~:~$python --version
Python 3.8.9

这里我们直接执行：

brew install python

耐心等待安装完成，其实Homebrew会将Python安装到/usr/local/Cellar/目录下，并在/usr/local/bin目录创建了链接文件。这里我们需要在~/.zshrc中添加相关配置并执行source ~/.zshrc重载配置：

# 环境变量配置
export SBIN=/usr/local/bin:/usr/local/sbin

# 写入环境变量
export PATH=$SBIN:$PATH

# 别名
alias python=python3
alias pip=pip3

查看一下版本，已经升级到最新版：

~:~$python --version
Python 3.10.10

/// openpyxl安装
pip install openpyxl

安装速度非常快：

~:~$pip install openpyxl
Collecting openpyxl
  Using cached openpyxl-3.1.0-py2.py3-none-any.whl (250 kB)
Requirement already satisfied: et-xmlfile in /usr/local/lib/python3.10/site-packages (from openpyxl) (1.1.0)
Installing collected packages: openpyxl
Successfully installed openpyxl-3.1.0

从 macOS Catalina 开始，Mac 使用 zsh 作为默认shell，而它的配置文件是用户目录下的.zshrc文件，所以我们之前在定义环境变量时都会编辑这个文件。每次打开终端时都会读取这个配置文件，如果需要在当前的shell窗口读取最新的环境配置则需要执行source ~/.zshrc，这也是之前我们编辑该文件后重载配置的原因（为了让最新的配置生效😁）。

export RUBY=/usr/local/Cellar/ruby/3.2.0/bin

其实我们之前在讲Ruby的安装时已经在~/.zshrc文件中定义过全局变量，语法就是在一个变量名前面加上export关键字。这里我们可以在终端输出一下这个变量：

~:~$echo $RUBY
/usr/local/Cellar/ruby/3.2.0/bin

变量的值可以正常输出，这也意味着这样的变量在当前shell程序中全局可读。