macOS 下常用代码版本控制工具安装及环境配置

小磊同学_8940

小磊同学_8940

2026-06-19

1037人浏览

原创

macos下最推荐的版本控制工具是git,安装首选homebrew(brew install git),其次xcode命令行工具或官方.pkg包;必须配置全局用户名与邮箱、启用osxkeychain凭证缓存、设置~/.gitignore_global忽略临时文件。

macos 下最常用、最推荐的代码版本控制工具是 git,它轻量、高效、生态成熟,且与 github、gitlab 等平台深度集成。安装和配置并不复杂,但关键步骤不能跳过——尤其是用户身份、凭证管理和全局忽略规则。

安装 Git(三种可靠方式)

macOS 系统默认不预装 Git,需手动安装。推荐按优先级选择以下任一方式:

  • Homebrew 安装(首选):适合大多数开发者,能持续更新、版本较新、路径清晰。
    先确认 Homebrew 是否已装:brew --version;未装则运行:
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    再执行:brew install git,完成后用 git --version 验证。
  • Xcode 命令行工具安装(系统级):不依赖第三方包管理器,Git 位于 /usr/bin/git,适合追求稳定或企业合规环境。
    终端中直接运行:xcode-select --install,按弹窗提示完成安装后,用 which git 确认路径。
  • 官方 .pkg 安装包(图形化):适合新手或需指定版本的用户。
    访问 https://www.php.cn/link/5f2397a240ce3565d4d3b82b0db2fc65,自动匹配 Apple Silicon 或 Intel 芯片下载最新安装包,双击运行,勾选“Install for all users”即可。

配置基础身份信息(必需)

Git 提交记录必须关联作者身份,否则无法正常推送或协作。该配置只需一次,作用于所有本地仓库:

  • 设置全局用户名:git config --global user.name "Your Name"
  • 设置全局邮箱:git config --global user.email "you@example.com"
  • 查看是否生效:git config --global --list,应看到 user.name 和 user.email 两行

注意:此处邮箱不要求真实可收信,但建议与 GitHub/GitLab 账号一致,便于提交记录自动关联。

启用钥匙串凭证缓存(省去重复输密)

每次向远程仓库 push 或 pull 时,若用 HTTPS 协议,会反复要求输入账号密码。启用 macOS 钥匙串集成后,首次验证通过即自动保存:

每天工作结束后,一键生成当日所有 Git 仓库的提交日报,支持多仓库扫描
每天工作结束后,一键生成当日所有 Git 仓库的提交日报,支持多仓库扫描

Git 提交日报助手,自动扫描当天(含次日凌晨6点前)所有仓库的 commit,生成结构化日报。

下载
  • 执行:git config --global credential.helper osxkeychain
  • 后续首次 push 会弹出钥匙串授权窗口,勾选“始终允许”即可
  • 之后所有操作不再提示,凭证安全存储在系统钥匙串中

设置全局 .gitignore(避免误提交垃圾文件)

每个项目单独写 .gitignore 很麻烦,macOS 开发中大量临时文件(如 .DS_Store、__pycache__、.vscode/)应统一屏蔽:

  • 创建文件:touch ~/.gitignore_global
  • 编辑并填入常用规则(可用 nano 或 VS Code):
    *.DS_Store<br>.Spotlight-V100<br>.Trashes<br>~*<br>*~<br>.vscode/<br>.idea/<br>__pycache__/
  • 启用该文件:git config --global core.excludesfile ~/.gitignore_global

验证方法:进任意 Git 仓库,执行 touch test.DS_Store && git status,该文件不应出现在未跟踪列表中。

可选增强:Git LFS(大文件支持)

若项目含设计稿、音视频、模型权重等大文件,建议安装 Git LFS,避免仓库臃肿:

  • 安装:brew install git-lfs
  • 初始化:git lfs install
  • 跟踪特定类型(如 PSD 文件):git lfs track "*.psd",再提交 .gitattributes

Git LFS 不改变工作流,仅将大文件替换为指针,拉取时按需下载实际内容。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

macos git 环境配置

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Docker容器化部署与DevOps实践
Docker容器化部署与DevOps实践

本专题面向后端与运维开发者,系统讲解 Docker 容器化技术在实际项目中的应用。内容涵盖 Docker 镜像构建、容器运行机制、Docker Compose 多服务编排,以及在 DevOps 流程中的持续集成与持续部署实践。通过真实场景演示,帮助开发者实现应用的快速部署、环境一致性与运维自动化。

2026.02.11

259

16

Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

2026.10.15

0

20

MySQL 忘记密码怎么办
MySQL 忘记密码怎么办

MySQL忘记密码专题汇集不同版本与系统下的root密码重置方法,覆盖MySQL 5.7、8.0、Mac、Linux及本地集成环境,并提示恢复权限与重新登录的检查步骤。

2026.10.15

0

18

Vue.js 中 ref 和 reactive 的区别
Vue.js 中 ref 和 reactive 的区别

Vue.js中ref和reactive的区别专题汇集两种响应式API的定义、访问方式、对象解构、侦听与性能取舍等文章,帮助结合实际状态类型选择合适写法。

2026.10.15

0

20

VS Code 怎么配置开发环境
VS Code 怎么配置开发环境

VS Code开发环境专题汇集编辑器安装、语言扩展、编译器、解释器、终端和调试配置文章,覆盖Java、Python、C++和PHP等常见语言的入门设置。

2026.10.15

0

18

C++ 开发环境怎么搭建
C++ 开发环境怎么搭建

C++开发环境专题汇集Windows、Linux下的编译器与IDE安装配置教程,涵盖GCC、Clang、Visual Studio、CLion和VS Code,以及编译运行首个程序的步骤。

2026.10.15

0

19

Python 虚拟环境是什么
Python 虚拟环境是什么

Python虚拟环境专题介绍项目依赖隔离的作用,汇集venv与uv创建、激活、退出及解释器切换的相关文章,并覆盖Windows、Linux和VS Code中的常见配置问题。

2026.10.15

0

15

Python 怎么安装并配置环境变量
Python 怎么安装并配置环境变量

Python安装与环境变量配置专题汇集Windows、macOS和Linux的安装步骤、PATH设置、pip配置及常见报错排查文章,帮助完成解释器安装并验证命令行可以正常运行。

2026.10.15

0

15

PHP 连接 MySQL 失败怎么办
PHP 连接 MySQL 失败怎么办

PHP连接MySQL失败专题汇集PDO与MySQLi扩展配置、账号权限、主机端口、套接字和认证方式等排查文章,覆盖连接报错、密码变更与容器环境配置,帮助按错误提示定位原因并修复。

2026.10.15

0

18

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Miniconda官方安装文档
Miniconda官方安装文档

共0课时 | 0人学习