文档教程开发工具【免费下载链接】mac-setupInstalling Development environment on macOS项目地址https://gitcode.com/gh_mirrors/ma/mac-setup点击查看免费下载本文将基于本仓库的 docs/git/index.md 文档内容系统讲解在 macOS 上安装、配置 Git 的完整流程涵盖 Git LFS、GitHub CLI、HTTPS 与 SSH 两种远程仓库连接方式以及.gitignore全局忽略规则的设置。你可以按照本文步骤从零开始完成 Git 环境搭建并与 GitHub 无缝协作。前置条件在开始安装 Git 之前需要先确保你的 macOS 已经安装了 Homebrew。Homebrew 是 macOS 上最流行的包管理器本文档后续的所有安装命令都依赖它。安装 Git在 macOS 上安装 Git 有多种方式本文推荐使用 Homebrew 进行安装brew install git安装完成后可以通过以下命令验证 Git 是否安装成功git --version如果安装成功该命令会输出 Git 的版本号。同时运行which git可以查看 Git 的安装位置Apple Silicon 芯片的 MacM1/M2 等/opt/homebrew/bin/gitIntel 芯片的 Mac/usr/local/bin/git注意如果which git输出的路径不同说明 Git 不是通过 Homebrew 安装的或者你的PATH环境变量配置需要调整。Git LFS大文件版本管理Git Large File StorageGit LFS是一个针对大文件的扩展工具它将大文件如二进制资源、数据集等用文本指针代替存储在 Git 仓库中而实际的大文件内容则存储在远程服务器上从而避免仓库体积膨胀和克隆速度变慢。安装并启用 Git LFSbrew install git-lfs git lfs install安装完成后在需要使用 LFS 的仓库中运行git lfs track来指定需要跟踪的大文件类型。GitHub CLI命令行上的 GitHubGitHub CLIgh让你无需离开终端即可完成创建 Pull Request、代码审查、管理 Issue 等 GitHub 操作。brew install gh安装完成后需要先进行认证gh auth login按照提示选择认证方式并登录你的 GitHub 账号即可。基础配置定义你的身份在首次使用 Git 之前需要配置你的用户名和邮箱这里推荐使用与 GitHub 相同的名称和邮箱git config --global user.name Your Name Here git config --global user.email your_emailyouremail.com这些配置会写入到你的~/.gitconfig文件中后续的git commit操作都会使用这个身份信息。凭据缓存避免每次输入密码当我们使用 HTTPS 方式推送代码时Git 默认会要求你每次输入用户名和密码。为了避免这种繁琐的验证过程可以在 macOS 上使用 Keychain 来缓存凭据git config --global credential.helper osxkeychain配置完成后第一次推送时 Git 会要求你输入凭据之后就会保存在 macOS 的钥匙串Keychain中下次推送时无需再次输入。使用 HTTPS 连接 GitHub推荐HTTPS 是连接 GitHub 的推荐方式因为它配置简单、无需管理密钥文件。使用 HTTPS 克隆仓库在 GitHub 上创建新仓库时勾选初始化 README 的情况下可以直接使用 HTTPS 地址克隆git clone https://github.com/username/repo-name.git如果你创建仓库时没有初始化 README请按照下一节的步骤进行设置。使用 HTTPS 设置新仓库或现有仓库如果你需要将本地目录与 GitHub 远程仓库关联起来首先至少添加一个文件并提交然后配置远程仓库并推送git remote add origin https://github.com/username/repo-name.git git push -u origin maingit remote add origin将远程仓库地址关联到本地仓库git push -u origin main将本地main分支推送到远程并设置上游跟踪分支之后就可以直接用git push推送。使用 SSH 连接 GitHub如果你更倾向于使用 SSH 而非 HTTPS请按照以下步骤配置。检查现有的 SSH 密钥首先检查你的电脑上是否已有 SSH 密钥ls -al ~/.ssh # 列出 .ssh 目录中的文件如果存在的话检查目录列表中是否有id_ed25519.pub或id_rsa.pub文件。如果没有任何一个文件请继续阅读下一节如果已经有密钥则可以跳过密钥生成步骤。生成新的 SSH 密钥如果你没有 SSH 密钥就需要生成一个。运行以下命令记得将占位符替换为你的邮箱ssh-keygen -t ed25519 -C your_emailexample.com # 创建一个新的 SSH 密钥使用提供的邮箱作为标签建议使用默认设置当提示输入保存密钥的文件名时直接按回车键继续即可。将 SSH 密钥添加到 ssh-agent运行以下命令将 SSH 密钥添加到ssh-agenteval $(ssh-agent -s)然后修改~/.ssh/config文件让系统自动加载密钥到 ssh-agent 并将口令保存到钥匙串Host * AddKeysToAgent yes UseKeychain yes IdentityFile ~/.ssh/id_ed25519最后将 SSH 密钥添加到 ssh-agentssh-add --apple-use-keychain ~/.ssh/id_ed25519将 SSH 密钥添加到 GitHub 账号最后一步是让 GitHub 认识你的 SSH 密钥。首先复制公钥到剪贴板pbcopy ~/.ssh/id_ed25519.pub然后前往 GitHub 的 SSH 密钥设置页面github.com/settings/ssh/new将密钥粘贴到 Key 文本框中并给密钥起一个代表当前电脑的名字例如 MacBook Pro。配置完成后就可以使用 SSH 与 GitHub 进行通信了。使用 SSH 克隆仓库创建新仓库后已初始化 README 的情况下使用 SSH 地址克隆git clone gitgithub.com:username/repo-name.git使用 SSH 设置新仓库或现有仓库如果你创建仓库时没有初始化 README可以先将本地仓库关联到 GitHubgit remote add origin gitgithub.com:username/repo-name.git git push -u origin main全局 Git 忽略规则创建全局忽略文件在 macOS 上有一些文件几乎在所有 Git 仓库中都不需要跟踪例如.DS_Store。可以创建一个全局的~/.gitignore文件来统一忽略它们# 文件夹视图配置文件 .DS_Store Desktop.ini # 缩略图缓存文件 ._* Thumbs.db # 外接磁盘上可能出现的文件 .Spotlight-V100 .Trashes # 编译后的 Python 文件 *.pyc # 编译后的 C 文件 *.out # 应用特定文件 venv node_modules .sass-cache创建好文件后在终端运行以下命令git config --global core.excludesfile ~/.gitignore这样配置之后所有 Git 仓库都会自动忽略这些文件无需在每个仓库中重复配置。使用 GitHub 官方维护的忽略规则你也可以直接下载 GitHub 官方维护的 macOS 特定 .gitignore将其内容保存到~/.gitignore。或者使用 Curl 直接下载curl https://raw.githubusercontent.com/github/gitignore/master/Global/macOS.gitignore -o ~/.gitignore生成自定义忽略规则如果你需要更多自定义的忽略规则可以访问 gitignore.io选择你需要的模板并生成配置。验证配置完成以上步骤后可以通过以下命令验证 Git 是否配置正确git config --list这个命令会列出所有当前的 Git 配置检查user.name、user.email、credential.helper和core.excludesfile是否都已正确设置。总结通过本文你已经在 macOS 上完成了 Git 的安装与配置包括使用 Homebrew 安装 Git、Git LFS 和 GitHub CLI配置 Git 用户身份和凭据缓存掌握 HTTPS 和 SSH 两种连接 GitHub 的方式设置全局忽略规则避免仓库中混入 macOS 系统文件。现在你的 macOS 已经具备完整的 Git 开发环境可以开始高效地与 GitHub 协作开发了。macOS 新机开发环境搭建Git 与 GitHub 完整配置指南本仓库mac-setup的文档 docs/git/index.md 系统地介绍了在 macOS 上从零安装与配置 Git 的完整流程覆盖了 Git 本体、Git LFS 大文件支持、GitHub CLI、HTTPS/SSH 两种远程协作方式以及全局忽略规则。读完本文你将能够在全新的 Mac 上完成 Git 环境搭建并熟练使用 HTTPS 或 SSH 与 GitHub 同步代码。前置条件Homebrew本指南中的所有安装命令都依赖 Homebrew。在开始之前请先确保 macOS 上已安装 Homebrew安装方法见 Homebrew 安装文档。安装 Git在 macOS 上安装 Git官方推荐直接使用 Homebrewbrew install git安装完成后验证 Git 是否安装成功git --version同时可以通过which git查看 Git 的实际安装位置正常情况下应当输出Apple SiliconM1/M2/M3/M4/opt/homebrew/bin/gitIntel/usr/local/bin/git如果你的which git输出的是/usr/bin/git说明系统 PATH 中仍然优先解析到了 Xcode 自带的 Git需要在~/.zshrc或~/.bash_profile中把/opt/homebrew/bin或/usr/local/bin提前。Git LFS大文件版本管理Git Large File Storage 用文本指针替换 Git 仓库中的大文件把真实文件内容存放在远程服务器上从而避免仓库体积暴涨、克隆与拉取变慢。brew install git-lfs git lfs installbrew install git-lfs安装 LFS 扩展git lfs install在全局注册 Git 过滤器钩子。之后在需要使用 LFS 的仓库里运行git lfs track *.psd按需指定模式并在.gitattributes中确认对应条目即可。GitHub CLIGitHub CLIgh把 GitHub 能力带到终端创建 PR、审查代码、管理 Issue 等都可以不离开命令行完成。brew install gh安装后先用 GitHub 账号认证gh auth login按照交互提示选择 HTTPS/SSH 与登录方式即可认证信息会保存在本机。定义 Git 身份提交代码前先定义全局 Git 用户推荐与 GitHub 用户名、邮箱保持一致git config --global user.name Your Name Here git config --global user.email your_emailyouremail.com这两项配置会被写入~/.gitconfig文件成为每次git commit的作者署名依据。缓存 GitHub 凭据使用 HTTPS 推送时Git 默认每次都会询问用户名与密码。为避免反复输入可以启用 macOS 钥匙串缓存git config --global credential.helper osxkeychain配置后第一次推送输入一次凭据之后 Git 会从系统钥匙串自动读取不再重复询问。使用 HTTPS 连接 GitHub推荐克隆仓库在 GitHub 创建新仓库并勾选初始化 README 后直接克隆git clone https://github.com/username/repo-name.git如果创建时未初始化 README则按下一节步骤操作。设置新仓库或现有仓库先至少添加一个文件并提交再关联远程仓库并推送git remote add origin https://github.com/username/repo-name.git git push -u origin main-u即--set-upstream让本地main分支与远程main建立跟踪关系之后可直接用git push/git pull。使用 SSH 连接 GitHub若希望避免每次输入凭据、也不想依赖钥匙串可以选择 SSH 方式。以下步骤摘自 GitHub 官方 SSH 文档流程。检查现有 SSH 密钥ls -al ~/.ssh # 列出 .ssh 目录中的文件如果存在的话查看是否存在id_ed25519.pub或id_rsa.pub。若都没有则继续下一步生成若已有则跳过生成环节。生成新的 SSH 密钥ssh-keygen -t ed25519 -C your_emailexample.com # 用提供的邮箱作为标签创建新的 SSH 密钥按提示确认保存路径直接回车使用默认位置~/.ssh/id_ed25519并按需设置口令passphrase。将密钥添加到 ssh-agent先启动 ssh-agenteval $(ssh-agent -s)然后修改~/.ssh/config让系统自动加载密钥并配合钥匙串保存口令Host * AddKeysToAgent yes UseKeychain yes IdentityFile ~/.ssh/id_ed25519最后将密钥加入 ssh-agentssh-add --apple-use-keychain ~/.ssh/id_ed25519将公钥添加到 GitHub 账号先复制公钥到剪贴板pbcopy ~/.ssh/id_ed25519.pub然后前往 GitHub 的 SSH 密钥设置页面github.com/settings/ssh/new将公钥粘贴到 Key 输入框并为它起一个能代表当前电脑的名称。完成后即可使用 SSH 与 GitHub 通信。使用 SSH 克隆仓库git clone gitgithub.com:username/repo-name.git使用 SSH 设置新仓库或现有仓库git remote add origin gitgithub.com:username/repo-name.git git push -u origin main全局忽略规则让 macOS 垃圾文件远离仓库创建~/.gitignoremacOS 的.DS_Store、外接磁盘的.Spotlight-V100等系统文件几乎永远不会被提交到仓库。可以创建全局忽略文件~/.gitignore# 文件夹视图配置文件 .DS_Store Desktop.ini # 缩略图缓存文件 ._* Thumbs.db # 外接磁盘上可能出现的文件 .Spotlight-V100 .Trashes # 编译后的 Python 文件 *.pyc # 编译后的 C 文件 *.out # 应用特定文件 venv node_modules .sass-cache然后让 Git 在所有仓库中默认读取该文件git config --global core.excludesfile ~/.gitignore下载 GitHub 官方 macOS 忽略规则也可以直接使用 GitHub 官方维护的 macOS 专属 .gitignore用 curl 一步到位curl https://raw.githubusercontent.com/github/gitignore/master/Global/macOS.gitignore -o ~/.gitignore按需生成忽略规则如果你需要为具体项目或语言生成忽略规则可以访问 gitignore.io选择模板后复制生成的内容。验证与总结完成以上配置后可用以下命令确认一切就绪git --version # Git 版本 git config --list # 查看全部全局配置 gh auth status # 查看 GitHub CLI 认证状态 ssh -T gitgithub.com # 测试 SSH 连接至此你的 macOS 已具备完整的 Git 开发环境通过 Homebrew 安装了 Git、Git LFS 与 GitHub CLI配置了全局身份与凭据缓存掌握 HTTPS 与 SSH 两种协作方式并让全局忽略规则自动过滤 macOS 系统文件。接下来即可在任意仓库中高效地进行版本管理与 GitHub 协作。赞分享文档教程开发工具【免费下载链接】mac-setupInstalling Development environment on macOS项目地址https://gitcode.com/gh_mirrors/ma/mac-setup点击查看免费下载相关推荐Windows 环境下搭建 RedwoodJS 开发环境的完整指南Git Bash nvm-windows YarnWindows 环境下搭建 RedwoodJS 开发环境的完整指南Git Bash nvm windows Yarn 本指南基于 RedwoodJS后端前端Web框架开发工具自主金融研究智能体如何构建系统化的AI金融分析架构自主金融研究智能体如何构建系统化的AI金融分析架构 Dexter是一个专为深度金融研究设计的自主智能体系统它通过智能任务分解、工具协同和迭代优化的技术架构人工智能AI Agent深度研究金融科技工具调用CLI在 Windows 上搭建 RedwoodJS 开发环境Git Bash nvm Yarn 完整指南在 Windows 上搭建 RedwoodJS 开发环境Git Bash nvm Yarn 完整指南 RedwoodJS 是一个全栈 React 框架后端前端Web框架开发工具上一篇30分钟构建精简版Windows 11Tiny11Builder完整指南下一篇Humanizer FluentDate 实战In.Eight 相对日期 API 完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考