当前位置： 首页 > article >正文

Mac开发环境配置- Shell/Homebrew/ruby

article 2024/10/30 11:17:26
前言

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

一、Homebrew

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

1. 安装

这里我们直接在终端执行国人写的一键安装脚本，换源（官方源的速度你懂的）啥的都直接安排上了。

 

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
 

 

image-20230209101341084
 

这里我们选择1、中科大下载源就好了，按照提示输入并耐心等待安装完成。
 

 

image-20230209102045211
 

 

image-20230209102929371
 

最后一步重载配置文件我们执行source ~/.zshrc，重载用户目录下的.zshrc。
 

到这里我们可以执行brew -v测试一下Homebrew的安装结果：
 

 

~:~$brew -v 
Homebrew 3.6.21-26-gb0a74e5 Homebrew/homebrew-core (git revision 4fbf6930104; last commit 2023-02-08) Homebrew/homebrew-cask (git revision cbce859534; last commit 2023-02-09)
 

有版本号输出说明已经安装完成了。
 

2. 卸载
 

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

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/HomebrewUninstall.sh)"
 

3. 常用命令
 

/// 安装
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 # 重启服务，并注册

 

二、Ruby
 

1. 安装
 

其实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中配置的路径。
 

2. Gem换源
 

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/
 

 

3. 常用包安装
 

/// 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都安装完成了。
 

三、Python
 

1. 使用Xcode自带Python库（推荐）
 

其实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
 

2. 使用Homebrew安装
 

这里我们直接执行：
 

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
 

3. pip换源
 

pip是python的包管理器，我们可以使用它来安装一些python库。我们可以更换一个国内源来提升下载速度：
 

/// 查看当前源
pip config list

/// 替换为清华大学源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

/// 还原为默认源
pip config unset global.index-url


 

  •  
    常用的国内镜像源
     
     
    阿里云 http://mirrors.aliyun.com/pypi/simple
豆瓣http://pypi.douban.com/simple
清华大学 https://pypi.tuna.tsinghua.edu.cn/simple
中国科学技术大学 http://pypi.mirrors.ustc.edu.cn/simple
华中科技大学 http://pypi.hustunique.com
中科大 https://pypi.mirrors.ustc.edu.cn/simple


     
 

4. 常用包安装
 

 

/// 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


 

 

四、Shell环境配置
 

1. zsh的配置文件.zshrc
 

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

2. 定义环境变量（全局变量）
 

 

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

 

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

 

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

 

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

3. 写入环境变量
 

常见的环境变量：
 

  • CDPATH：冒号分隔的目录列表，作为cd命令的搜索路径
  • HOME：当前用户的主目录
  • PATH：shell查找命令的目录列表，由冒号分隔
  • BASH：当前shell实例的全路径名
  • PWD：当前工作目录
 

这里重点关注一下PATH变量，当我们在shell命令行界面中输入一个外部命令时，shell必须搜索系统来找到对应的程序。PATH环境变量定义了用于进行命令和程序查找的目录：
 

 

echo $PATH
 

 

某些时候我们执行命令会遇到command not found这样的报错，比如：
 

 

~:~$hi
zsh: command not found: hi
 

这是因为PATH中的目录并没有包含hi命令，所以我们执行hi就报错。同理，当我们在配置环境时，某些库的目录需要被写入到PATH中，比如：
 

 

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

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


 

这样当我们执行具体的命令时，shell才能够正确的访问。
 

  •  
    附.zshrc常见配置
     
     
    # 环境变量配置
export SBIN=/usr/local/bin:/usr/local/sbin
export HOMEBREW=/usr/local/Homebrew/bin
export RUBY=/usr/local/Cellar/ruby/3.2.0/bin
export GEMS=/usr/local/lib/ruby/gems/3.2.0/bin

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

# 别名
alias python=python3
alias pip=pip3

# 编码
export LC_ALL=en_US.UTF-8
export LANG=en_US.UTF-8

# 控制PS1信息
PROMPT='%U%F{51}%1~%f%u:~$'

# 镜像源
export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles


     
 

五、参考文档
 

  • Homebrew 常用命令
  • Python pip 国内换源的几个办法

                

        

        

				
				

					

					http://www.kler.cn/a/371472.html
					
				

                

                  
相关文章：

				  
                        

  • Linux特种文件系统--tmpfs文件系统 
    • 


  • 计算机网络IP地址分类，子网掩码，子网划分复习资料 
    • 


  • 241024-Ragflow离线部署Docker-Rootless环境配置修改 
    • 


  • 重学SpringBoot3-怎样优雅停机 
    • 


  • LeetCode：459重复的子字符串 
    • 


  • 软件测试工程师晋升方向，你选对了吗？ 
    • 

                      
  • 
                        ele-table表格列表内，双击编辑部分信息（el-table组件同理）
                      
    • 
                    
                      
  • 
                        C# OpenCvSharp DNN UNet 推理
                      
    • 
                    
                      
  • 
                        华为手机系统应用瘦身
                      
    • 
                    
                      
  • 
                        了解桌面机床用于学校教学培训应用-桌面级CNC机床
                      
    • 
                    
                      
  • 
                        Debug日程工作经验总结日程常用
                      
    • 
                    
                      
  • 
                        五指cms安装
                      
    • 
                    
                      
  • 
                        ubuntu20.04系统安装
                      
    • 
                    
                      
  • 
                        使用Python和OpenCV实现火焰检测
                      
    • 
                    
                      
  • 
                        c++ assert
                      
    • 
                    
                      
  • 
                        [机器学习]集成学习
                      
    • 
                    
                      
  • 
                        Docker架构
                      
    • 
                    
                      
  • 
                        [论文阅读]SimCSE: Simple Contrastive Learning of Sentence Embeddings
                      
    • 
                    
                      
  • 
                        Topaz Video AI for Mac 视频无损放大软件安装教程【保姆级，操作简单轻松上手】
                      
    • 
                    
                      
  • 
                        《ToDesk 云电脑、易腾云、青椒云移动端体验实测：让手机秒变超级电脑》
                      
    • 
                    
                      
  • 
                        鸿蒙NEXT应用上架与分发
                      
    • 
                    
                      
  • 
                        沧穹科技室内音频“北斗”定位技术亮相第三届北斗规模应用国际峰会
                      
    • 
                    
                      
  • 
                        面试题整理1
                      
    • 
                    
                      
  • 
                        Flume采集Kafka数据到Hive
                      
    • 
                    
                      
  • 
                        【力扣 + 牛客 | SQL题 | 每日4题】牛客SQL热题210，213，212，219
                      
    • 
                    
                      
  • 
                        PART 1 数据挖掘概论 — 数据挖掘方法论
                      
    •