运行Yarn时iTerm2出现Segmentation Fault或Bus Error的解决求助

彻底卸载并重装Yarn #

• 先移除现有Yarn，根据安装方式选择对应命令：
  • npm全局安装的：npm uninstall -g yarn
  • Homebrew安装的：brew uninstall yarn
• 手动清理残留文件：删除~/.yarn、~/.config/yarn目录，同时检查~/.bashrc、~/.zshrc等shell配置文件，移除Yarn相关的环境变量行
• 重新安装Yarn：
  • 用Homebrew：brew install yarn
  • 用官方脚本：curl -fsSL https://yarnpkg.com/install.sh | bash

排查iTerm2配置冲突 #

• 关闭所有自定义shell插件（如Oh My Zsh的第三方插件），恢复shell配置为默认状态后重试
• 创建全新的iTerm2配置文件（Profiles -> 复制现有配置），仅保留默认设置，再运行Yarn命令
• 禁用iTerm2的「Use Unicode version 9 character widths」选项（路径：Profiles -> Text），部分字符渲染异常可能触发内存错误

修复系统底层依赖 #

• 更新Xcode Command Line Tools：运行xcode-select --install，按提示完成安装或更新
• 检查并修复Homebrew依赖：brew doctor，根据输出提示修复存在的问题
• 重装核心系统库：如brew reinstall curl，解决底层库损坏导致的调用崩溃

调整Yarn运行参数 #

• 尝试离线模式安装：yarn install --offline，排除网络请求环节的异常
• 切换Yarn镜像源：yarn config set registry https://registry.npmmirror.com，避免原镜像的请求问题

清理项目本地缓存 #

• 删除项目根目录的node_modules文件夹，以及Yarn缓存目录（Yarn 1为~/.yarn/cache，Yarn 2+为项目内的.yarn/cache）
• 重新执行yarn install，让Yarn重新拉取依赖文件

内容的提问来源于stack exchange，提问作者Soungjae Lee