需安装Git for Windows并配置全局用户信息、SSH密钥及验证连接;具体包括下载安装、设置user.name/user.email、生成ed25519密钥并添加至GitHub、ssh -T测试连接、初始化仓库并推送首次提交。

如果您希望在Windows系统上搭建Git开发环境,需要完成Git for Windows的安装以及基本配置,包括设置全局用户名、邮箱和SSH密钥。以下是具体操作步骤:
一、下载并安装Git for Windows
Git for Windows是专为Windows平台优化的Git发行版,包含Git命令行工具、图形化界面(Git GUI)、Bash模拟环境(Git Bash)等组件,安装过程会引导用户选择关键配置项。
1、访问Git官方下载页面 https://git-scm.com/download/win,页面将自动识别Windows系统并提供最新安装包。
2、双击运行下载的 Git-*.exe 安装文件,以管理员身份启动安装向导。
3、在“Select Components”页面中,勾选 Add a Git Bash profile to Windows Terminal(如已安装Windows Terminal),其余默认选项保持勾选即可。
4、在“Adjusting your PATH environment”页面中,选择 Git from the command line and also from 3rd-party software,确保CMD、PowerShell及IDE均可调用git命令。
5、在“Choosing the SSH executable”页面中,选择 Use OpenSSH(系统自带,无需额外安装)。
6、在“Configuring the line ending conversions”页面中,选择 Checkout Windows-style, commit Unix-style line endings,适配跨平台协作。
7、点击“Install”,等待安装完成,勾选 Launch Git Bash 并点击Finish。
二、配置全局用户名和邮箱
Git要求每次提交都关联一个用户身份,全局配置将应用于本机所有仓库,避免每次新建项目重复设置。
1、打开Git Bash终端(开始菜单搜索“Git Bash”并启动)。
2、执行以下命令设置用户名:git config --global user.name "YourName",将 YourName 替换为您的实际姓名或昵称(英文或中文均可,建议使用英文避免编码问题)。
3、执行以下命令设置邮箱:git config --global user.email "youremail@example.com",邮箱需与GitHub/GitLab等平台注册账号一致。
4、验证配置是否生效:运行 git config --global --list,确认输出中包含正确的 user.name 和 user.email 行。
三、生成并配置SSH密钥用于远程仓库认证
SSH密钥对可实现免密码安全连接代码托管平台(如GitHub、GitLab),私钥保存在本地,公钥添加至平台账户。
1、在Git Bash中执行:ssh-keygen -t ed25519 -C "youremail@example.com",其中邮箱必须与步骤二中配置的全局邮箱一致。
2、提示“Enter a file in which to save the key”时,直接按回车使用默认路径 /c/Users/用户名/.ssh/id_ed25519。
3、连续两次回车跳过密钥口令(passphrase)设置(如需更高安全性,可输入口令并牢记)。
4、执行 cat ~/.ssh/id_ed25519.pub 查看公钥内容,复制全部输出(以 ssh-ed25519 AAAA... 开头,以邮箱结尾)。
5、登录GitHub网站,进入 Settings → SSH and GPG keys → New SSH key,Title填写设备标识(如“Windows-Laptop”),Key type选择“Authentication Key”,粘贴公钥内容,点击“Add SSH key”。
四、验证SSH连接有效性
配置完成后需测试本地SSH客户端能否成功与GitHub建立认证连接,排除网络、防火墙或密钥格式错误等问题。
1、在Git Bash中运行:ssh -T git@github.com。
2、首次连接会提示确认主机指纹,输入 yes 并回车。
3、若看到类似 Hi username! You've successfully authenticated... 的欢迎消息,说明SSH配置成功。
4、如提示 Permission denied (publickey),请检查是否遗漏公钥上传、是否使用了错误的邮箱参数生成密钥、或是否误删了私钥文件。
五、初始化本地仓库并推送首个提交
完成基础配置后,可通过创建新仓库并推送至远程,验证整个Git工作流是否畅通。
1、在任意目录下新建文件夹,右键选择“Git Bash Here”,或在终端中执行 mkdir my-project && cd my-project。
2、运行 git init 初始化空仓库。
3、创建测试文件:echo "# My Project" > README.md。
4、执行 git add README.md 将文件加入暂存区。
5、执行 git commit -m "initial commit" 完成首次提交。
6、在GitHub网页端新建空仓库(不勾选Initialize with a README),复制其SSH地址(形如 git@github.com:username/repo.git)。
7、在本地执行:git remote add origin git@github.com:username/repo.git,替换为实际地址。
8、执行 git branch -M main 确保主分支名为main(GitHub默认)。
9、执行 git push -u origin main 推送本地提交到远程仓库。










