众元AI学习空间

03_Git安装与本地配置手册

7分钟阅读

Git for Windows 安装与本地配置手册

首次使用：W01-D01“Git 保存可比较的起点”。W02 再系统学习仓库、协作与跨环境重建。

本手册先关闭本地 Git 安装、PATH 和提交身份门；GitHub 账号、认证、远端仓库见下一本手册，Actions 在 W03-D04 使用。

1. 先检查，不重复安装

在 TRAE 的 PowerShell 终端执行：

git --version
where.exe git
Get-Command git -All

通过标准：

  • git --version 能显示版本；
  • where.exe git 指向预期的 Git for Windows，而不是已删除软件的残留路径；
  • 同一终端中实际执行的 git.exe 与记录一致。

若全部通过，直接进入第 3 节。

2. 使用官方安装器

  1. 打开 Git for Windows 官方安装页。
  2. 普通 Intel/AMD Windows 下载 x64 Setup；Windows on ARM 才选 ARM64。
  3. 双击安装器。学校电脑出现管理员提示时按组织流程处理。
  4. 安装器页面名称可能随版本变化，课程采用以下选择原则：
    • 组件：保留命令行 Git、Git Bash、Git Credential Manager；是否创建桌面图标按个人习惯。
    • 默认编辑器：可选 TRAE 已支持的编辑器或保留默认；课堂提交信息主要使用 git commit -m，不依赖编辑器。
    • PATH：选择能从命令行和第三方软件使用 Git 的选项，确保 TRAE 终端可以调用。
    • SSH：使用 Git for Windows 自带的 OpenSSH，除非组织已经统一配置外部 OpenSSH。
    • HTTPS：使用系统/Windows 安全通道或安装器推荐值；组织网络有证书策略时听从管理员，不关闭证书验证。
    • 行尾转换、终端和 git pull 行为：课堂保持安装器推荐值，不在不了解项目规则时全局改写。
    • Credential Manager：保留启用，W03 通过 HTTPS 连接 GitHub 时用浏览器完成授权。
  5. 完成安装后，彻底退出并重开 TRAE。
  6. 新开终端执行：
git --version
where.exe git
git --exec-path
ssh -V
git credential-manager --version

如果官方网页下载暂时不便、电脑已经具备 Windows Package Manager，也可以在本人确认包 ID 后使用官方页面给出的命令：

winget install --id Git.Git -e --source winget

安装完成仍必须重开 TRAE 并执行上面的验收，winget 显示成功不能代替真实命令验证。

最后一条如果因当前发行版命令名变化而不可用，不代表 Git 本身失败；先以 git --version、命令来源和本地提交为必过项，再由教师检查 Credential Manager 组件。

3. 配置提交身份

先查看现状：

git config --global user.name
git config --global user.email

没有输出时，由学生本人决定课程提交身份：

git config --global user.name "你的姓名或课程公开名"
git config --global user.email "你确认可用于提交的邮箱"
git config --global init.defaultBranch main

注意：

  • user.name 是提交作者名，不是 GitHub 登录名或密码。
  • 如果以后公开仓库，不想公开私人邮箱，可在 GitHub 完成账号设置后改用 GitHub 提供的 noreply 邮箱。
  • 共用电脑不要替别人写全局身份。可进入自己的仓库后使用不带 --global 的本地配置。
  • 不运行来历不明的“Git 一键优化脚本”，不全局关闭 SSL 校验。

检查全部来源：

git config --list --show-origin

4. 做一次不联网的本地验收

在自己的课程位置新建测试目录并进入：

New-Item -ItemType Directory -Path git_local_check
Set-Location -LiteralPath .\git_local_check
git init
git branch -M main

在 TRAE 中创建 README.md：

# Git local check

回到终端：

git status
git add README.md
git diff --staged
git commit -m "test: verify local git"
git log --oneline -1
git status

通过标准：

  • 仓库根目录就是 git_local_check；
  • git diff --staged 只出现预期文件；
  • git log --oneline -1 出现本次提交；
  • git status 最终为 clean；
  • 全程没有执行 git push，因为本节只验证本地 Git。

测试目录由学生保留到 W03 远端练习结束。不要在没确认路径前批量删除。

5. 常见故障

git 仍然找不到

彻底退出 TRAE 后重开，再执行 where.exe git。若安装器没有把 Git 加入可供第三方软件使用的 PATH，重新运行官方安装器并修改该选项。

Author identity unknown

执行第 3 节身份配置，并用 git config --list --show-origin 找到设置来源。不要把 GitHub 密码填进 email。

仓库初始化到了错误父目录

先执行：

git rev-parse --show-toplevel
git status

若范围包含大量无关文件，停止 add/commit，由教师确认仓库边界后处理。不要在课程父目录上直接运行删除 .git 的命令。

LF will be replaced by CRLF

这是行尾转换提示，不等于代码失败。先保留提示并按项目规则提交；不要为了消除提示随意改全局 core.autocrlf。

GitHub 要求密码但密码无效

这是下一本手册的认证问题。GitHub 已不使用账号密码完成 Git 命令行 HTTPS 认证；优先让 Git Credential Manager 打开浏览器授权。

6. 提交证据

Git 版本：
git.exe 路径：
提交身份来源：全局 / 仓库本地
测试仓库根目录：
最新 commit：
git status：
仍待处理的问题：

反向链接