git命令行需安装正确、配置无误、远程地址可用三者缺一不可；git --version无响应多因path未配置，windows须勾选“use git from command line”，macos/linux需确认$path包含git路径，验证须在原生命令行执行。
Git 命令行能直接拉下项目、提交代码、切换分支，但前提是安装正确、配置无误、远程地址可用——缺一不可。很多“git pull 失败”问题，其实卡在前两步。
git --version 没反应？先确认安装路径和环境变量
Windows 上装完 Git，默认不自动加进系统 PATH，右键菜单里能看到 Git Bash，但 cmd 或 PowerShell 里输 git --version 报“不是内部或外部命令”，就是这个原因。
- 重装时务必勾选 "Use Git from the command line and also from 3rd-party software"（不是默认选项）
- Mac/Linux 用 Homebrew 或 apt 安装一般没问题，但若用 dmg 或源码编译，得手动把
/usr/local/bin或/opt/homebrew/bin加进$PATH - 验证方式不是只看 Git Bash 里能否运行，而要在系统原生命令行（cmd/PowerShell/Terminal）中执行
git --version，有输出才算真正就位
git clone 失败常见错误及对应解法
git clone 卡住、报错或拉空目录，90% 出现在协议选择、权限或分支名上。
-
fatal: unable to access 'https://...': Failed to connect to github.com port 443→ 公司网络可能屏蔽 HTTPS，换 SSH：git clone git@github.com:user/repo.git，但需提前配好 SSH 密钥 -
Repository not found→ 检查 URL 是否拼错；私有仓库要确认账号有权限；GitHub 新建仓库默认分支是main，不是master，URL 末尾带/tree/master这类路径不能直接 clone - 克隆后
ls -a看不到代码文件，只有.git→ 说明远程仓库本身是空的，或者没 push 过任何 commit
git pull origin main 提示 “couldn’t find remote ref main”
这是分支名不匹配导致的，不是网络或权限问题。
- 老项目常用
master，新项目默认main，执行git branch -r查看远程所有分支，真实分支名可能叫origin/develop或origin/trunk - 如果远程只有
origin/master，就该用git pull origin master - 想让本地也自动跟踪同名分支，首次拉取建议加
-u参数：git pull -u origin main，之后直接git pull就行
为什么 git config --global user.name 不生效？
全局配置只影响新初始化的仓库；已存在的本地仓库会优先读取其 .git/config 里的本地配置，覆盖全局设置。
- 进到项目目录后，运行
git config --list --show-origin，能清楚看到每条配置来自哪个文件 - 如果发现
.git/config里有重复的user.name，直接编辑该文件删掉或改掉即可 - 提交时作者信息出错（比如显示成别人邮箱），十有八九是这里被本地配置劫持了，不是全局没设
Git 命令行本身没有界面反馈，错误信息全靠文字，所以别跳过 git status 和 git remote -v 这两个最轻量却最关键的诊断命令。很多看似“拉不下来”的问题，其实是远程仓库压根没收到过一次有效 push。
