分布式版本控制系统Git的安装和使用

分布式版本控制系统Git的安装和使用

🌈个人主页: Hygge_Code🔥热门专栏:从0开始学习Java | Linux学习| 计算机网络💫个人格言: “既然选择了远方,便不顾风雨兼程”

在这里插入图片描述

文章目录

一、关于版本控制

1. 什么是“版本控制”?

• 版本控制是一种记录一个或若干文件内容变化,以便将来查阅特定版本修订情况的系统

2. 版本控制系统(VCS)带来的好处🐦‍🔥

•可以将选定的文件回溯到之前的状态,甚至将整个项目都回退到过去某个时间点的状态
•可以比较文件的变化细节,查出最后是谁修改了哪个地方,从而找出导致问题的原因
• 就算你把整个项目中的文件改的改删的删,你也照样可以轻松恢复到原先的样子

3. 版本控制系统分类

• 本地版本控制系统(如:RCS)
• 集中化的版本控制系统(如:CVS、Subversion)
分布式版本控制系统(如:Git、Mercurial、Bazaar)

二、Git核心

1. 三大文件状态

Git通过三种状态精准管理代码变化,每一步操作都对应状态的转换:

  • 已修改(modified):文件在工作区被修改,但尚未存入本地数据库,是代码变化的“初始状态”。
  • 已暂存(staged):对已修改文件的当前版本做标记,确认这部分修改会纳入下次提交的快照,相当于给代码“拍了张待存档的照片”。
  • 已提交(committed):暂存区的快照被永久存入Git目录(本地数据库),代码进入“安全存储”状态。

这三种状态对应Git项目的三个核心区域:工作区(实际编写代码的文件夹)、暂存区(临时存放待提交修改的文件)、Git目录(存储元数据和对象数据库的核心区域)=

在这里插入图片描述

2. 四步完成一次代码提交

Git的基础操作围绕“修改-暂存-提交-同步”展开,每一步都有明确的目标:

  1. 工作区修改:在本地项目文件夹中编写或修改代码,比如新增一个user.js文件实现用户登录功能。
  2. 暂存区标记:通过git add命令将需要提交的修改加入暂存区,可精准选择单个文件(git add user.js)或所有修改(git add .),避免误提交无关内容。
  3. 本地库提交:用git commit -m "新增用户登录功能:实现账号密码验证"将暂存区内容存入本地Git目录,同时填写清晰的提交信息,方便后续追溯。
  4. 远程库同步:通过git push将本地提交推送到远程仓库(如GitHub、GitLab),或用git pull拉取远程最新代码,确保团队协作时版本一致。

三、Git实战:从环境配置到命令详解

1. 环境配置

安装Git后,首要任务是配置用户信息——这会写入每一次提交,成为你的“身份标识”,在团队协作中至关重要:

# 全局配置(所有本地仓库通用)git config --global user.name "你的姓名"git config --global user.email "你的工作邮箱"# 查看配置是否生效git config --list # 单独查看某项配置,如用户名git config user.name 

若需要为特定项目配置不同信息,只需进入项目目录,去掉--global参数重新执行命令即可。

Git的安装操作

Git的下载安装 (图文教程)

2. 本地操作命令

本地仓库是Git操作的基础,常用命令覆盖了从初始化到版本回溯的全流程:

命令功能说明示例
git init初始化本地仓库,生成隐藏的.git目录cd 项目文件夹 && git init
git status查看文件状态,区分已修改、已暂存、未跟踪文件git status
git add将文件添加到暂存区git add *.js(添加所有JS文件)
git commit提交暂存区内容到本地仓库git commit -m "修复登录页表单验证bug"
git log查看提交历史,--oneline参数可简化输出git log --oneline
git rm从版本库移除文件(同时删除本地文件)git rm obsolete.js
git mv移动或重命名文件,保留版本记录git mv oldname.js newname.js
git reset取消暂存区文件,或回溯版本git reset HEAD user.js(取消user.js暂存)
git checkout撤销工作区修改,或切换分支git checkout -- user.js(撤销user.js未暂存的修改)

3. 远程操作命令

远程仓库是团队共享代码的核心,以下命令覆盖了远程仓库的管理与同步:

代码同步

# 从远程仓库抓取代码(不合并到工作区)git fetch origin # 拉取远程代码并合并到当前分支(多人协作常用)git pull origin main # 推送本地分支到远程仓库(首次推送需加-u关联分支)git push -u origin main # 克隆远程仓库到本地(初始化新项目时用)git clone https://github.com/你的账号/项目名.git 

查看/管理远程仓库

# 查看已配置的远程仓库(-v显示详细URL)git remote -v # 添加远程仓库,命名为origin(默认名称)git remote add origin https://github.com/你的账号/项目名.git # 重命名远程仓库(如将origin改为github)git remote rename origin github # 移除远程仓库git remote remove github # 查看某个远程仓库的详细信息git remote show origin 

当拉取远程代码遇到“无关历史”冲突时,可添加--allow-unrelated-histories参数强制合并,如git pull origin main --allow-unrelated-histories

四、Git分支与标签

1. 分支:隔离开发

  • 分支协作流程
    1. 接到需求后,从主分支(main)创建功能分支(如feature/user-profile)。
    2. 在功能分支开发完成后,切换回主分支(git checkout main)。
    3. 合并功能分支到主分支(git merge feature/user-profile)。
    4. 确认无误后,删除功能分支(git branch -d feature/user-profile),若分支未合并需强制删除,用git branch -D 分支名

核心分支命令

# 创建分支(如开发新功能的feature/payment分支)git branch feature/payment # 切换分支git checkout feature/payment # 创建并切换分支(推荐用法)git checkout -b feature/payment # 查看所有分支(当前分支前带*)git branch # 查看分支最后一次提交git branch -v 

2. 标签:标记重要版本

在项目发布节点(如V1.0、V2.0),用标签标记特定提交,能快速定位发布版本,方便后续维护。Git标签分为两种:

标签同步:默认git push不推送标签,需手动推送:

# 推送单个标签到远程git push origin v1.0 # 推送所有标签到远程git push origin --tags 

附注标签:包含标签者信息、创建时间、附注描述,更适合团队共享:

git tag -a v1.0 -m "V1.0版本:完成用户注册、登录、商品列表功能"

轻量标签:仅存储提交校验和,适合本地临时标记:

git tag v1.0 # 给当前提交打轻量标签

五、版本库目录与编码规范

1. 版本库目录规范

混乱的目录结构会增加团队协作成本,统一的目录规范能提升开发效率。推荐的Git仓库根目录结构如下:

项目根目录/ ├─ documents/ # 项目相关文档(需求文档、设计文档、测试报告等) ├─ projects/ # 项目源代码(按模块划分,如前端项目放projects/frontend,后端放projects/backend) ├─ README.md # 项目说明文档(中文),包含项目介绍、目录结构、环境搭建步骤等 └─ README.en.md# 项目说明文档(英文),方便国际协作 

可参考模板仓库(https://gitee.com/zero-awei/hello-gitee.git)快速搭建目录结构,确保团队成员遵循统一标准。

在这里插入图片描述

2. 编码规范

编码规范是团队协作的“语言共识”,Git仓库需配合编码规范与检查工具,确保代码质量:

  • 常用编码规范
    • Java项目:遵循《阿里巴巴Java开发手册》,涵盖命名规范、注释要求、异常处理等细节。
    • 多语言通用:参考《Google开源项目风格指南》,适配C++、Python、JavaScript等多种语言。
  • 编码检查工具

C++:用Cpplint工具,可集成到Visual Studio等IDE,配置示例:

命令:D:\software\Python27\python.exe 参数:Tools\Scripts\cpplint.py --output=vs7 --filter=-build/include_subdir 初始目录:$(ItemDir) 

通过工具自动化检查,能减少人工 review 成本,让代码风格保持一致。

六、冲突解决

例如:

在这里插入图片描述

多人协作时,同一文件的同一部分被修改,合并分支会触发冲突。Git会在冲突文件中标记冲突区域,只需三步即可解决:

  1. 查看冲突:执行git status,会显示“both modified: 冲突文件名”,明确冲突文件。
  2. 提交结果:执行git add 冲突文件名将修改加入暂存区,再用git commit提交(无需额外写信息,Git会自动生成冲突解决日志)。

修改文件:打开冲突文件,Git用<<<<<<< HEAD(当前分支内容)、=======(待合并分支内容)、>>>>>>> 分支名标记冲突区域,按需保留代码并删除标记。例如:

# 冲突前 <<<<<<< HEAD String welcome = "欢迎登录"; ======= String welcome = "Welcome to Login"; >>>>>>> feature/i18n # 冲突后(保留国际化版本) String welcome = "Welcome to Login"; 

若冲突复杂,可使用git mergetool启用可视化冲突解决工具(如VS Code、Beyond Compare),降低操作难度。


如果我的内容对你有帮助,请 点赞 , 评论 , 收藏 。创作不易,大家的支持就是我坚持下去的动力!

在这里插入图片描述

Read more

Logseq+cpolar:让开源笔记效率翻倍

Logseq+cpolar:让开源笔记效率翻倍

文章目录 * 前言 * **核心价值对比传统方案** * **cpolar赋能远程访问** * 1. 安装Docker * 2. 简单使用演示 * 3. 安装cpolar内网穿透 * 4. 配置公网地址 * 5. 配置固定公网地址 * 当开源软件遇上内网穿透技术,Logseq+CPolar的组合正在重构知识管理的边界。或许真正的生产力革命,始于把数据主权握在自己手中。 前言 还在为商业笔记软件的订阅费用、数据隐私条款或功能限制感到困扰吗?或许你该试试用 Logseq(GitHub 3.3万星)搭配 cpolar内网穿透工具,打造一个完全自主可控的知识管理生态系统。 核心价值对比传统方案 Logseq特性商业软件痛点解决开源无隐藏数据收集避免用户行为被分析利用Markdown+Org-Mode双引擎兼容程序员与学术研究双重需求原生支持PDF批注解决专业文档管理的碎片化问题 cpolar赋能远程访问 这对组合带来以下突破: * 私有化数据存储:将笔记文件存放在本地NAS/旧PC,通过Logseq桌面端运行,再用CPolar生成

By Ne0inhk
【Git】GitHub 连接失败解决方案:Failed to connect to github.com port 443 after 21090 ms: Couldn’t connect to se

【Git】GitHub 连接失败解决方案:Failed to connect to github.com port 443 after 21090 ms: Couldn’t connect to se

文章目录 * 一、使用 VPN 环境下的解决方案 * 1. 检查当前代理设置 * 2. 配置 Git 使用代理 * 3. 验证代理设置是否生效 * 4. 刷新 DNS 缓存 * 5. 重新尝试 Git 操作 * 二、未使用 VPN 环境下的解决方案 * 1. 取消 Git 配置的代理 * 2. 验证代理设置已成功移除 * 3. 重试 Git 操作 * 三、总结 * 使用 VPN 的解决方案: * 未使用 VPN 的解决方案: 在使用 Git 进行代码管理时,可能会遇到“Failed to connect

By Ne0inhk
用 Rust 构建 Git 提交历史可视化工具

用 Rust 构建 Git 提交历史可视化工具

在软件开发中,版本控制系统的历史记录往往承载着项目的演进脉络。然而,当项目规模扩大、分支增多时,纯文本的 git log 输出很难直观地展现提交之间的复杂关系。今天,我想分享一个用 Rust 构建的轻量级工具 —— git-graph-rs,它能把 Git 仓库的提交历史转换为可视化的图结构,为代码审查、项目复盘和工程决策提供直观的支持。 目录 * 为什么需要可视化? * 技术方案的选择 * 1. 利用系统 Git 命令 * 2. 模块化的 Rust 架构 * 3. 双格式输出策略 * 核心实现解析 * Git 数据获取的艺术 * 图结构的一致性保证 * 合并提交的可视化区分 * 工程化思维体现 * 错误处理的前置化 * 参数设计的克制 * 输出格式的稳定性 * 实际应用场景 * 1. CI/CD 集成 * 2. 代码审查辅助 * 3. 项目文档化

By Ne0inhk