更换Ruby Gem镜像源是解决国内访问慢、超时或403错误的必要操作；需先移除https://rubygems.org/等旧源，再添加并验证https://gems.ruby-china.com/为唯一有效源。

Mac终端更换Ruby Gem镜像源是安装CocoaPods或更新gem包前的必要操作，因为系统默认的https://rubygems.org/在国内访问极慢甚至超时，不换源会导致gem install卡死、报错403或connection timeout。

确认当前Gem源状态

打开终端，执行以下命令查看当前配置的源：

gem sources -l

如果输出中显示 *** CURRENT SOURCES *** 下只有 https://rubygems.org/ 或已失效的 https://ruby.taobao.org/，说明必须更换；若已存在 https://gems.ruby-china.com/ 且为唯一源，则无需继续操作。

移除旧源（如有）

逐条执行移除命令，不要跳过——即使提示“not present”，也需确保旧源彻底清理干净：

gem sources --remove https://rubygems.org/

gem sources --remove http://ruby.taobao.org/

gem sources --remove https://gems.ruby-china.org/

注意：taobao源早在2021年已停止维护，【强行使用会触发403错误】；ruby-china.org 域名也已于2023年统一升级为 .com 后缀，旧地址将返回无效响应。

添加并验证新源

第一步：添加当前可用的国内主镜像源

gem sources --add https://gems.ruby-china.com/

第二步：强制刷新源缓存，避免本地残留旧索引

gem sources -u

第三步：验证是否生效

gem sources -l

成功时终端应仅显示一行有效源：*** CURRENT SOURCES *** → https://gems.ruby-china.com/。如果出现多个源（如同时含 .org 和 .com），后续所有 gem 操作都会随机失败，必须回到上一步彻底清空再重试。