[Windows]-Git初始化配置

在 Windows 环境下配置 Git,除了基础的“身份认证”,最核心的诉求通常就是“免密登录”(不用每次 push 都输密码)和“好用”(中文不乱码、命令补全等)。

我为你整理了一套Windows 专属的 Git 初始化配置清单,按照这个流程走一遍,你的 Git 环境就非常舒适了。

1. 安装Git

下载地址:访问 Git for Windows 官网 下载最新版安装包。(一般下载比较慢,可以在腾讯软件中心下载)

安装过程中的关键选项(请务必注意):

  1. 选择组件:保持默认,建议勾选 Add a Git Bash Profile to Windows Terminal(如果你使用 Windows Terminal)。
  2. 选择默认编辑器:新手强烈建议在下拉菜单中选择 Notepad ,避免使用 Vim(新手噩梦)。
  3. 配置环境变量(关键)
    • 选择 Git from the command line and also from 3rd-party software
    • 作用:让你在 Windows 的 CMD 或 PowerShell 里也能直接使用 Git 命令。
  4. 配置行尾转换(关键)
    • 选择 Checkout Windows-style, commit Unix-style line endings
    • 作用:这是 Windows 的标准配置,能防止跨平台协作时出现换行符报错。
  5. 其余步骤保持默认,一路点击 Next 直到安装完成。

2.基础身份配置(必做)

这是 Git 的“身份证”,每次提交代码都会记录这些信息。

打开 Git Bash,依次输入以下命令(记得替换成你自己的信息):

# 设置用户名(建议用英文,方便团队识别)
git config --global user.name "你的名字"

# 设置邮箱(必须和 GitHub/Gitee 注册邮箱一致,否则关联不上头像)
git config --global user.email "你的邮箱@example.com"

3. 配置免密登录(核心需求)

在 Windows 上,实现免密主要有两种方式,推荐方式一,更符合 Windows 的使用习惯。

方式一:使用 Windows 凭据管理器(推荐 HTTPS 协议)

这种方式最简单,不需要生成复杂的密钥文件。Git 会调用 Windows 自带的凭据管理器保存你的账号密码。

  1. 开启凭据助手
    在 Git Bash 中输入:

    git config --global credential.helper manager
    
  2. 如何使用
    当你第一次 git pushgit clone 私有仓库时,系统会弹出一个 Windows 登录框。输入账号密码并勾选“记住我的凭据”后,以后就再也不会弹窗了。

方式二:使用 SSH 密钥(推荐 GitHub/GitLab 重度用户)

如果你经常操作 GitHub,或者公司内网限制 HTTPS,建议使用 SSH。

  1. 生成密钥(推荐用 ed25519 算法,更安全;老系统用 rsa):

    ssh-keygen -t ed25519 -C "你的邮箱@example.com"
    
    • 提示保存路径时:直接按 回车(使用默认路径)。
    • 提示输入密码时:直接按 回车(留空,实现完全免密)。
  2. 获取公钥内容
    输入以下命令查看并复制生成的公钥:

    cat ~/.ssh/id_ed25519.pub
    
    • 注意:复制的内容必须以 ssh-ed25519 开头。
  3. 配置到远程平台
    登录 GitHub/Gitee -> 设置 -> SSH 公钥 -> 粘贴刚才复制的内容 -> 保存。

  4. 测试连接(看清楚是github还是gitee):

    ssh -T git@github.com
    # 如果是 Gitee:ssh -T git@gitee.com
    

    看到 Hi username! You've successfully authenticated... 就说明配置成功了。

4. Windows 专属优化配置(避坑指南)

Windows 和 Linux/Mac 的换行符不一样,如果不配置,可能会导致代码全是乱码或者无法提交。

# 1. 解决换行符问题(Windows 必配!)
# 作用:提交时自动转为 LF,检出时自动转为 CRLF,避免全文件报错
git config --global core.autocrlf true

# 2. 解决中文文件名乱码
# 作用:让 git status 能正常显示中文文件名
git config --global core.quotepath false

# 3. 开启彩色显示
# 作用:让 diff 和 status 信息带颜色,更易读
git config --global color.ui auto

5. 提升效率的“偷懒”配置(可选)

配置一些别名,让你敲命令更快。

# 用 git st 代替 git status
git config --global alias.st status

# 用 git co 代替 git checkout
git config --global alias.co checkout

# 用 git br 代替 git branch
git config --global alias.br branch

# 用 git ci 代替 git commit
git config --global alias.ci commit

📌检查配置

最后,确认一下所有设置是否生效:

git config --list
posted @ 2026-03-30 21:12  Ching_Fire  阅读(24)  评论(0)    收藏  举报