文档教程开发工具【免费下载链接】mac-setupInstalling Development environment on macOS项目地址https://gitcode.com/gh_mirrors/ma/mac-setup点击查看免费下载本篇指南围绕 mac-setup 仓库中的 docs/homebrew/usage.md 展开系统讲解 macOS 开发环境下 Homebrew Formula 的完整生命周期管理从安装、更新、搜索、升级、清理到卸载的每个命令行操作并给出经过筛选的推荐 Formula 清单GNU 核心工具与代码搜索工具帮助你真正把 Homebrew 变成日常开发的基础设施。读完本篇你将掌握一套可复制、可验证的 Homebrew 日常操作流并理解它与仓库中 Git、iTerm2、Python、Node 等章节的协作关系。brew 命令总览Formula 的生命周期在 Homebrew 的术语中通过brew安装的每个软件包被称为Formula公式。mac-setup 仓库将其使用文档组织在 docs/homebrew/usage.md并把整个 Homebrew 章节安装、使用、Cask编排在 sidebars.ts 的Homebrew分类下与 iTerm2、Git、Python 等章节并列说明它是后续所有开发环境搭建的公共基础。安装一个 Formula安装软件包即 Formula最简单直接brew install formula例如安装 Git 及配套工具见 docs/git/index.mdbrew install git brew install git-lfs brew install gh而仓库中其他章节也大量使用这一命令例如安装ack见 docs/iterm/ack.md、安装 Python见 docs/python/index.md等。可以说brew install是 mac-setup 全篇各语言/工具章节共同依赖的入口命令。更新 Homebrew 的 Formula 目录Homebrew 本地维护一份所有可用 Formula 的索引目录。要同步这份目录运行brew update注意如果该命令失败可以手动拉取公式目录。公式目录本身是一个 Git 仓库位于 Homebrew 前缀目录下因此可以像普通 Git 仓库一样重置cd $(brew --prefix)/Homebrew/ git fetch origin git reset --hard origin/main这里brew --prefix会输出 Homebrew 的安装前缀Apple Silicon 为/opt/homebrewIntel 为/usr/localgit reset --hard origin/main则把本地索引强行对齐到远端main分支通常能解决索引损坏或版本不一致的问题。查看哪些 Formula 可以升级brew outdated该命令列出所有已安装但版本已滞后的 Formula是决定是否执行升级的依据。升级指定 Formulabrew upgrade formula如果你不带参数运行brew upgrade则会升级所有过期 Formula。建议先用brew outdated确认范围再有针对性地升级。清理旧版本Homebrew 会在系统上保留 Formula 的旧版本以备需要回滚到较早版本时使用。但这种情况很少发生因此可以定期清理以释放磁盘空间brew cleanup如果只想预览Homebrew 将要删除哪些内容而并不实际删除它们使用 dry-run 模式brew cleanup --dry-run这是文档中特别强调的安全实践先查看再执行避免误删仍需要的旧版本。查看已安装内容及版本brew list --versions该命令列出所有已安装的 Formula 及其版本号适合快速核对环境中各组件的版本也是排查依赖冲突的常用起点。搜索与查看信息在安装前先搜索某个 Formula 是否可用brew search formula搜索到目标后查看它的详细信息依赖、安装选项、当前版本、统计等brew info formula卸载 Formulabrew uninstall formula注意brew uninstall与brew cleanup的区别前者移除指定的 Formula含其二进制文件后者清理的是所有 Formula 遗留的过期版本。结合使用可以保持系统整洁。安装前提从零开始用上 brewusage.md假定你已经装好了 Homebrew。完整的安装流程记录在 docs/homebrew/index.md可以概括为三步安装 Xcode 命令行工具提供编译器和从源码构建所需工具xcode-select --install运行官方安装脚本并回车跟随屏幕指引/usr/bin/env bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)配置PATHApple Silicon MacM1/M2/M3/M4上 Homebrew 安装到/opt/homebrew需要把下面这行加入~/.zprofileBash 用户则加入~/.bash_profileeval $(/opt/homebrew/bin/brew shellenv)Intel Mac 上 Homebrew 安装到/usr/local通常已在PATH中。装好后新开一个终端会话并运行健康检查brew doctor如果一切正常你将看到没有警告并提示 ready to brew!。这与usage.md的日常命令形成完整的「安装 → 配置 → 日常使用」闭环。推荐 Formula用 GNU 工具补齐 macOS 自带命令macOS 自带的许多命令行工具是过时或 BSD 版本。usage.md推荐安装一批 GNU 版本的核心工具来补齐体验brew install \ coreutils \ moreutils \ findutils \ gnu-sed \ grep \ wget \ bash \ base64各工具用途简述coreutilsGNU 核心工具集涵盖ls、cat、cp等基础命令的现代实现moreutils额外的实用小工具集合如sponge、vidir等findutilsGNU 版find、xargs、locate支持更丰富的表达式选项gnu-sedGNU 版sed支持-i等 macOS BSD sed 所缺的特性grepGNU 版grep功能远超 BSD grepwget命令行下载工具macOS 不自带bash新版本 Bash替换 macOS 默认的 3.2 老版本base64编码/解码工具。注意GNU 工具默认以g前缀安装例如gsed、gfind。要无前缀直接使用它们需要把各自的libexec/gnubin目录加入PATH。Homebrew 在安装每个 Formula 后都会在终端打印对应的配置指引按提示操作即可。典型做法是把这些目录放在PATH的最前面让 GNU 版本优先于系统自带版本被调用。搜索工具The Silver Searcheragusage.md还推荐了一个针对代码搜索场景的工具brew install the_silver_searcherThe Silver Searcherag是与ack类似的代码搜索工具但速度更快。mac-setup 仓库在 docs/iterm/ack.md 中对ack做了展开介绍并同样推荐安装the_silver_searcherbrew install the_silver_searcherag的用法与ack类似例如直接搜索关键词ag pancakesag默认跳过.gitignore中忽略的文件、二进制文件和 VCS 目录开箱即用地对源码目录进行递归搜索适合日常在大型代码库中定位符号与文本。延伸安装 GUI 应用用 Caskbrew install安装的是命令行程序Formula而 macOS 上的图形界面应用则通过Homebrew-Cask安装命令为brew install --cask package。mac-setup 的 docs/homebrew/cask.md 给出了完整分类清单例如浏览器brave-browser、终端warp、编辑器cursor、zed、sublime-text等。判断一个软件该用 Formula 还是 Cask可以先用brew search package查看结果中是否带--cask标记或运行brew info package确认。日常维护建议结合usage.md与仓库其余章节推荐形成以下日常操作习惯定期运行brew update同步公式索引若失败则按文首的 Git 方式手动重置用brew outdated检查可升级项再用brew upgrade formula逐个升级避免一次性大批量升级引入依赖问题升级后运行brew cleanup --dry-run预览确认无误再brew cleanup释放磁盘用brew list --versions记录环境快照方便在 mac-setup 各章节Git、Python、Node 等的配置之间交叉核对版本遇到异常先运行brew doctor做健康检查。以上所有命令均可在本仓库文档体系中找到对应出处与上下文安装与 PATH 配置见 docs/homebrew/index.mdGUI 应用安装见 docs/homebrew/cask.md而各语言/工具章节如 docs/git/index.md、docs/iterm/ack.md、docs/python/index.md则把brew install作为统一入口持续复用构成了整份 mac-setup 指南的实操骨架。赞分享文档教程开发工具【免费下载链接】mac-setupInstalling Development environment on macOS项目地址https://gitcode.com/gh_mirrors/ma/mac-setup点击查看免费下载相关推荐Homebrew Cask 升级工具buo/homebrew-cask-upgrade 安装与使用指南Homebrew Cask 升级工具buo/homebrew cask upgrade 安装与使用指南 项目介绍 Homebrew Cask 升级工具是一个命开发工具mac-setup应用管理使用Homebrew Cask安装常用软件的完整指南mac setup应用管理使用Homebrew Cask安装常用软件的完整指南 想要在macOS上快速安装开发环境和日常应用吗mac setup项目为你提供文档教程开发工具macOS 清理工具 mac-cleanup-py 安装与使用指南macOS 清理工具 mac cleanup py 安装与使用指南 一、项目目录结构及介绍 mac cleanup py 是一个专为 macOS 设计的Pyth上一篇Garph完全指南TypeScript全栈GraphQL开发的终极框架下一篇TypeScript 7 工作区符号搜索作用域用 workspaceSymbols.scope 把多项目中的符号搜索限定到当前项目创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考