如果您希望在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 推送本地提交到远程仓库。
评论(0)