跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言

Git 安装流程、环境配置与基础使用步骤

Git 安装流程涵盖下载官方安装包、配置环境变量及编辑器。通过 Git Bash 设置用户名邮箱并生成 SSH 密钥实现免密登录。基础工作流包括初始化仓库、暂存文件、提交本地记录及关联远程推送。常见坑点涉及 .gitignore 配置、大文件管理(如模型权重)及换行符转换问题,建议提前规划忽略规则并使用 Git LFS 处理大文件。

魔法巫师发布于 2026/3/22更新于 2026/10/1590 浏览
Git 安装流程、环境配置与基础使用步骤

前言

Git 是管理代码的工具,无论是在搭建前后端分离的复杂架构,还是在调试庞大的深度学习模型,一个清晰、规范的版本控制系统能帮你避开无数次'代码重构'带来的崩溃。Git 工具在大学期间实训时和工作中都会用到,本文将介绍在新电脑上安装 Git 工具及基础使用方法。

一、Git 下载与安装步骤

前往 Git 官方网站(https://git-scm.com/),点击对应系统的安装包链接,下载最新的 64-bit Git for Windows Setup。

双击下载的 exe 程序开始安装,依次点击 Next 进入下一步:

  1. 许可协议:接受协议。
  2. 选择组件:默认即可。
  3. 选择开始菜单文件夹:默认即可。
  4. 选择附加任务:个人使用选'Use the OpenSSL library'。
  5. 调整初始分支名:推荐选择'Override the default branch name for new repositories',并在文本框中填入 main。这是目前的行业通用标准,能减少推送到远端时的命名冲突。
  6. 编辑器设置:默认的是 vim 编辑器,一般使用默认的即可;后续可手动修改。
  7. 路径配置:这一步按照默认即可。
  8. 选择安装目录:建议安装除 C 盘外的其他盘,选择完成后点击 Next。
  9. 完成安装:下载完成后,点击 Finish 结束安装。

二、环境配置

安装完成后,在桌面空白处右键,选择'Open Git Bash here'(或者在终端中打开 Git Bash),进行基础信息的全局配置。

1. 配置用户名和邮箱

每次提交代码都会记录这些信息,这是必须执行的一步。

git config --global user.name "你的英文昵称或姓名"
git config --global user.email "你的常用邮箱@example.com"

2. 生成 SSH 密钥

不配置 SSH,每次推送代码都需要频繁输入账号密码。目前推荐使用更安全的 ed25519 算法。

ssh-keygen -t ed25519 -C "你的常用邮箱@example.com"

连续按三次回车(不设置额外密码)。生成后,输入以下命令查看并复制你的公钥内容,将其粘贴到 GitHub 或 Gitee 的 SSH Keys 设置中:

cat ~/.ssh/id_ed25519.pub

3. 配置 Notepad++ 为默认编辑器

Notepad++ 是一个非常经典的轻量级选择,打开速度极快,用来写 Git 的提交信息再合适不过了。你需要指定它的绝对路径,并且加上几个特定的启动参数,这样才能确保 Git 会乖乖等待你写完并关闭窗口后再继续执行,而不是瞬间闪退报错。

打开 Git Bash 或终端,输入以下命令,更换成你自己的 notepad++.exe 路径:

git config --global core.editor "'E:/1-ProgramFiles/Notepad++/notepad++.exe' -multiInst -notabbar -nosession -noPlugin"
  • -multiInst: 强制打开一个新的 Notepad++ 独立窗口。
  • -nosession: 启动时不加载你上次没关掉的历史文件,保持输入界面绝对清爽。
  • -notabbar: 隐藏顶部的标签栏,让它看起来就是一个纯粹的文本输入框。
  • -noPlugin: 禁用插件加载,实现'秒开',写完就关,绝不拖泥带水。

配置完成后,以后每次遇到需要写复杂提交说明的情况(比如直接敲了 git commit),系统就会秒开一个干净的 Notepad++。需要写好内容,按下 Ctrl + S 保存,然后关掉这个窗口,Git 就会自动读取并完成提交了。

三、从零开始:Git 基础工作流

理解 Git 的四个区域是掌握它的关键:工作区(你写代码的地方)、暂存区(计划提交的改动)、本地仓库(保存历史记录)和远程仓库(云端代码)。

1. 初始化本地仓库

进入你的项目文件夹,右键打开 Git Bash,输入:

git init

这会在当前目录下生成一个隐藏的 .git 文件夹,你的本地仓库就建立好了。

2. 将文件添加到暂存区

告诉 Git 你想保存哪些文件的改动。

git add .

(注意:add 后面的 . 代表添加当前目录下所有改动的文件。)

3. 提交到本地仓库

给这次改动写一个简短的说明,将其永久记录在本地。

git commit -m "feat: 初始化项目架构"

4. 关联远程仓库并推送代码

在云端(如 GitHub/Gitee)新建一个空仓库后,复制其 SSH 地址,执行以下命令:

git remote add origin 你的远程仓库 SSH 地址
git push -u origin main

四、新手必看:高频'翻车'坑点与解决方案

  • 灾难 1:没有配置 .gitignore 文件

    • 坑点: 直接 git add . 会把本地的编译文件、虚拟环境或依赖包全部传到云端。比如 Python 的 __pycache__ 和 venv,或者前端 Vue 项目中动辄几百兆的 node_modules。这不仅会导致推送极慢,还会让仓库迅速膨胀。
    • 解决: 在执行第一次 git add . 之前,务必在项目根目录创建一个名为 .gitignore 的文件,将不需要版本控制的目录名写进去。
  • 灾难 2:大文件导致推送失败

    • 坑点: Git 不适合管理超大文件。如果你把动辄几百 MB 的模型权重文件(比如 YOLO 的 .pt 文件)或者庞大的数据集直接 commit,git push 时大概率会报错并拒绝接收。
    • 解决: 将数据集目录和权重文件加入 .gitignore。如果确实需要管理大文件,需要额外安装配置 Git LFS (Large File Storage)。
  • 灾难 3:换行符警告 (LF will be replaced by CRLF)

    • 坑点: 在 Windows 上经常会遇到这个警告,虽然不影响核心代码,但满屏的警告非常干扰视线。
    • 解决: 运行命令 git config --global core.autocrlf true 让 Git 自动处理换行符转换即可放心忽略。

目录

  1. 前言
  2. 一、Git 下载与安装步骤
  3. 二、环境配置
  4. 1. 配置用户名和邮箱
  5. 2. 生成 SSH 密钥
  6. 3. 配置 Notepad++ 为默认编辑器
  7. 三、从零开始:Git 基础工作流
  8. 1. 初始化本地仓库
  9. 2. 将文件添加到暂存区
  10. 3. 提交到本地仓库
  11. 4. 关联远程仓库并推送代码
  12. 四、新手必看:高频“翻车”坑点与解决方案

更多推荐文章

查看全部
  • C++ 继承进阶:友元、静态成员与菱形继承底层逻辑
  • C++高性能游戏渲染优化实践:减少 CPU-GPU 等待时间的 4 种方法
  • 基于企业微信 WebSocket 搭建 WorkBuddy AI 助手
  • Java 中 BigDecimal 与 double 精度差异及 SQL 数值类型处理
  • 宇树 G1 机器人开发:有线与无线连接配置实战
  • 基于 OpenClaw 整合 Qlib 与 RD-Agent 构建 AI 量化系统
  • Ubuntu 下 libwebkit2gtk-4.1-0 安装指南
  • 利用 AI 编程工具零代码开发小红书卡片 MCP
  • JavaScript 完整语法指南
  • C++ STL list 容器详解:使用与模拟实现
  • 2026 年全球主流 AI 大模型解析
  • C#属性与C++成员变量的核心哲学差异对比
  • JavaScript 表格处理指南:数据流转到动态可视化
  • Linux 文件 I/O 本质与内核视角:从 fopen 到 open
  • MySQL 事务详解:概念、特性与隔离级别
  • OpenClaw 飞书多机器人与多 Agent 落地复盘
  • AI 模型调优实战:Python 核心技术与最佳实践
  • 提示词工程师:AI 大模型时代的新兴职业与技术解析
  • Android AOP 面向切面编程实现用户行为统计
  • Nanobot 实战:基于 vLLM 部署智能 QQ 聊天机器人

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online