跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言AI大前端

Git 安装配置与基础工作流实战指南

Git 版本控制系统是开发必备工具。本文涵盖 Windows 下 Git 的安装配置、SSH 密钥生成、Notepad++ 编辑器绑定以及基础工作流操作。重点解析.gitignore 忽略规则、大文件处理及换行符冲突等常见坑点,帮助开发者快速搭建规范的开发环境。

心动瞬间发布于 2026/3/24更新于 2026/5/2233 浏览
Git 安装配置与基础工作流实战指南

Git 环境搭建与基础使用

Git 作为代码版本管理的核心工具,无论是前后端分离架构还是深度学习模型调试,一个规范的版本控制系统都能避免无数次重构带来的崩溃。在新电脑上手 Git,除了安装,更重要的是理解其背后的工作逻辑。

一、Windows 下安装流程

前往 Git 官网下载 Windows 版安装包。运行后一路点击 Next 即可,但有几个关键选项需要留意:

  1. 分支命名:在调整初始分支名时,建议勾选 Override the default branch name for new repositories,并将文本框填入 main。这是目前的行业通用标准,能减少推送到远端时的命名冲突。
  2. 编辑器选择:默认是 vim,一般保持默认即可,后续可手动修改为更顺手的工具。
  3. 安装路径:建议安装在非 C 盘目录,避免系统盘空间不足。

安装完成后,点击 Finish 结束向导。

二、环境配置与 SSH 密钥

安装完成后,在桌面空白处右键选择 "Open Git Bash here",进行基础信息的全局配置。

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 等待窗口关闭后再继续。

在终端输入以下命令(请替换为你自己的 notepad++.exe 路径):

git config --global core.editor "'E:/1-ProgramFiles/Notepad++/notepad++.exe' -multiInst -notabbar -nosession -noPlugin"
  • -multiInst: 强制打开独立窗口。
  • -nosession: 启动时不加载历史文件,界面清爽。
  • -notabbar: 隐藏标签栏,纯文本输入框。
  • -noPlugin: 禁用插件,秒开秒关。

配置完成后,执行 git commit 时会自动唤起 Notepad++,保存并关闭窗口即可完成提交。

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

掌握 Git 的四个区域是关键:工作区、暂存区、本地仓库和远程仓库。

1. 初始化本地仓库 进入项目文件夹,右键打开 Git Bash:

git init

这会在当前目录下生成隐藏的 .git 文件夹,本地仓库建立完成。

2. 将文件添加到暂存区 告诉 Git 你想保存哪些文件的改动:

git add .

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

3. 提交到本地仓库 给这次改动写一个简短说明,永久记录在本地:

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

4. 关联远程仓库并推送 在云端新建空仓库后,复制 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 的模型权重文件或数据集 commit,git push 大概率会报错。解决:将数据集目录和权重文件加入 .gitignore。如需管理大文件,需额外安装配置 Git LFS。

  • 灾难 3:换行符警告 (LF will be replaced by CRLF) 在 Windows 上常遇到此警告,虽不影响核心代码但干扰视线。解决:运行命令 git config --global core.autocrlf true 让 Git 自动处理换行符转换即可。

目录

  1. Git 环境搭建与基础使用
  2. 一、Windows 下安装流程
  3. 二、环境配置与 SSH 密钥
  4. 三、从零开始:Git 基础工作流
  5. 四、新手必看:高频坑点与解决方案
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • Git 合并时忽略特定文件的 6 种实用技巧
  • C++ 搜索二叉树:核心特性、实现与实战
  • 数据结构:顺序表与链表核心算法实战
  • 本地部署 Llama 3.1:Ollama、OpenWeb UI 与 Spring AI 集成指南
  • 基于 Flask 与 PyTorch 的图像分类 API 服务搭建
  • C++ 二叉搜索树:原理与增删查实现详解
  • Ubuntu 24.04 深度学习环境配置:NVIDIA 驱动与 CUDA 安装验证
  • Git 原理与进阶使用:远程协作、标签管理与企业级模型
  • SpringAI 通过 Ollama 本地部署 Deepseek 模型实现对话机器人
  • 基于 AI 工具快速生成计算机课题技术路线图
  • Linux 进程间通信进阶:管道与共享内存
  • Python 调用高德地图 MCP 服务查询天气实战
  • 2025 年 AIGC 六大核心发展趋势
  • log4js 库二次封装
  • AIGC 内容创作:AI 文字、图像、音频和视频的创作流程
  • 开源浪潮下的中国力量:文心一言大模型本地部署与应用全攻略
  • AIGC 内容创作:AI 文字、图像、音频和视频生成流程
  • 利用 AI 智能体快速生成 C 语言成绩管理与前端博客项目
  • Mac Intel 芯片安卓模拟器安装与使用指南
  • C++ 二维差分解决矩阵区间更新问题

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

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

  • Base64 文件转换器

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

  • Markdown转HTML

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