Windows系统下Git的详细安装步骤和基础设置指南

Written by

in

文章目录
  • 如果安装时未勾选 Add Git to PATH,需手动配置: 右键点击 此电脑 > 属性 > 高级系统设置 > 环境变量。 在 系统变量 中找到 Path,点击 编辑。 添加 Git 安装路径下的 bin 目录(如 C:Program FilesGitbin)。 点击确定保存。
  • 目录
    • 一、详细安装步骤
      • 1. 下载 Git 安装包
      • 2. 运行安装程序
        • 1. 双击安装包,按以下选项配置:
        • 2. 点击 Install 完成安装。
    • 二、验证安装
      • 1. 打开 PowerShell 或 CMD:
        • 2. 检查 Git 版本:
        • 三、基础配置
          • 1. 设置全局用户名和邮箱
            • 2. 生成 SSH 密钥(绑定 GitHub)
              • 1. 打开 Git Bash:
              • 2. 生成密钥:
              • 3. 复制公钥到剪贴板:
              • 4. 粘贴公钥内容并保存
          • 四、配置环境变量(可选)
            • 五、常用命令演示
              • 1. 克隆仓库
                • 2. 提交代码
                  • 3. 拉取远程更新
                  • 六、常见问题解决
                    • 1. 提交时提示身份验证失败
                      • 2. Git Bash 中中文乱码
                        • 3. 路径过长报错
                        • 七、推荐工具
                          • 1. 图形化客户端:
                            • 2. 编辑器集成:

                            本文提供了Windows系统下Git的完整安装配置指南,包含详细步骤和常见问题解决方案。主要内容包括:1)从官网下载安装包并完成配置;2)验证安装及基础设置(用户名、邮箱、SSH密钥);3)环境变量配置方法;4)常用Git命令示例;5)常见问题处理(身份验证、中文乱码、路径过长等);6)推荐使用的图形化客户端工具。通过本指南,用户可快速完成Git环境搭建并掌握基本使用技巧,为代码版本管理做好准备。

                            以下是 Windows 系统下 Git 的详细安装步骤和基础设置指南:

                            • 访问 Git 官网,点击页面上的 Download for Windows。
                            • 根据系统版本(10/11)下载最新安装包(文件名类似 Git-xxx-64-bit.exe)。

                            • Component Selection:
                              勾选 Git for Windows 和 Git Bash Here(推荐保留,默认会安装常用工具)。
                            • Path:
                              保持默认路径(C:Program FilesGit),避免空格或特殊字符导致的问题。
                            • Git Bash Terminal:
                              勾选 Use the system’s default console window(推荐使用 PowerShell 或 CMD 会更灵活)。
                            • Line ending conversion:
                              选择 Checkout as-is, commit with CRLF(国内用户推荐,避免换行符问题)。
                            • Terminal emulator:
                              保持默认的 Git Bash。
                            • SSH executable:
                              选择 Git’s built-in ssh.exe。
                            • Other options:
                              勾选 Add Git to PATH(关键步骤,否则命令行无法识别 git)。

                            Win + R 输入 cmdpowershell,按回车。

                            输入以下命令,确认输出版本号:

                            git --version

                            如果显示版本信息(如 git version 2.40.1),表示安装成功。

                            git config --global user.name "你的真实姓名"    # 用于提交记录的作者名
                            git config --global user.email "你的邮箱@example.com"  # 绑定 GitHub 等平台账号
                            

                            Win + R 输入 gitbash,按回车。

                            ssh-keygen -t ed25519 -C "你的邮箱@example.com"
                            
                            • 按回车接受默认路径(~/.ssh/id_ed25519)。
                            • 提示输入密码时直接连续按两次回车(不设置密码短语)。

                            cat ~/.ssh/id_ed25519.pub | clip
                            

                            登录 GitHub,进入 Settings > SSH and GPG keys,点击 New SSH key,粘贴公钥内容并保存。

                            如果安装时未勾选 Add Git to PATH,需手动配置:

                            1. 右键点击 此电脑 > 属性 > 高级系统设置 > 环境变量。
                            2. 在 系统变量 中找到 Path,点击 编辑。
                            3. 添加 Git 安装路径下的 bin 目录(如 C:Program FilesGitbin)。
                            4. 点击确定保存。

                            git clone https://github.com/用户名/仓库名.git
                            

                            # 进入项目目录
                            cd 仓库名
                            
                            # 添加文件到暂存区
                            git add <文件名/相对路径/绝对路径>      # 添加单个文件
                            git add .  # 添加全部文件 git add *    
                            
                            # 提交并附加说明
                            git commit -m "Initial commit"
                            
                            # 关联远程仓库(首次推送)
                            git remote add origin https://github.com/用户名/仓库名.git
                            
                            # 推送代码到主分支
                            git push -u origin main
                            

                            git pull origin main
                            

                            • 确保已绑定 SSH 密钥,或在 HTTPS 协议下输入 GitHub 账号的密码。
                            • 若使用 SSH,检查密钥权限:
                            chmod 600 ~/.ssh/id_ed25519
                            

                            • 修改终端编码:
                            export LANG=en_US.UTF-8
                            export LC_CTYPE=en_US.UTF-8
                            
                            • 或将系统语言设置为 UTF-8。

                            • 启用 Git 的长路径支持(需管理员权限):
                            git config --global core.longpaths true
                            

                            • Sourcetree(免费)
                            • GitHub Desktop

                            • VS Code、Sublime Text 等支持 Git 插件。

                            完成以上步骤后,你就可以熟练使用 Git 进行版本控制了!如果有具体问题,欢迎随时提问。

                            以上就是Windows系统下Git的详细安装步骤和基础设置指南的详细内容,更多关于Windows下Git安装配置的资料请关注风君子博客其它相关文章!

                            您可能感兴趣的文章:

                            • Windows系统安装使用Git的详细教程
                            • Git在Windows中安装与使用教程
                            • Windows系统下安装GIt及GIT基本认识和配置
                            • Windows 系统下的 Git 2.7 最新下载及安装教程图文详解
                            • windows下gitbash安装教程(小白教程)

                            站内搜索