ubuntu桌面版18.04起多预装git，服务器版通常未安装；先运行git --version确认，未安装则用sudo apt install git安装，再配置ssh密钥和用户信息，最后初始化仓库并推送。
确认系统是否已预装 Git
Ubuntu 桌面版从 18.04 起多数已预装 git，但服务器版或最小化安装通常没有。别急着装，先敲：git --version
如果返回类似 git version 2.34.1，说明已就位；若提示 command not found，才需要安装。
用 apt 安装 Git（推荐绝大多数人）
Ubuntu 官方源里的 Git 版本虽不是最新，但足够稳定、兼容性好，且能随系统自动更新。不用折腾 PPA 或源码编译，除非你明确需要某个新特性（比如 git restore 的增强行为或稀疏索引支持）。
- 更新软件包索引：
sudo apt update - 安装 Git：
sudo apt install git - 验证：
git --version（当前 Ubuntu 24.04 LTS 默认装的是 2.43.x，2026 年主流服务器仍多为 2.39–2.45 区间）
⚠️ 注意：别用 apt-get install git-all——它会拉一堆你用不到的文档和调试工具，增大磁盘占用，且无实际功能增益。
初始化配置前必须做的一件事：生成 SSH 密钥
Git 本身不传代码，真正传输靠的是 ssh 或 HTTPS。如果你要用 GitHub、GitLab、Gitee 等平台推送代码，https 方式每次 push 都要输密码（或 Token），而 ssh 方式配一次密钥就能免密操作——这才是日常开发的真实流程。
- 运行：
ssh-keygen -t ed25519 -C "your_email@example.com"（优先用ed25519，比rsa更快更安全；旧系统不支持时再退到rsa -b 4096） - 密钥默认存于
~/.ssh/id_ed25519和~/.ssh/id_ed25519.pub - 复制公钥内容：
cat ~/.ssh/id_ed25519.pub | xclip -sel clip（需先sudo apt install xclip），或手动打开文件复制 - 粘贴到对应平台的 SSH Keys 设置页（如 GitHub → Settings → SSH and GPG keys）
测试是否生效：ssh -T git@github.com。成功时会看到 Hi XXX! You've successfully authenticated...。如果卡住或报 Permission denied (publickey)，大概率是没加 agent 或权限不对——此时运行 eval "$(ssh-agent -s)" 和 ssh-add ~/.ssh/id_ed25519 再试。
基础仓库初始化与首次提交
配置完用户名邮箱后，才能 commit；但注意：这些只是 commit 元数据，和 SSH 认证无关，也不影响 push 是否成功。
- 设全局身份（仅需一次）：
git config --global user.name "Your Name"，git config --global user.email "you@example.com" - 进项目目录，初始化：
git init - 加文件：
git add .（注意点号，不是星号） - 提交：
git commit -m "init" - 关联远程（以 GitHub 为例）：
git remote add origin git@github.com:username/repo.git（务必用git@...格式，这是走 SSH 的标志） - 推送到主分支：
git push -u origin main（注意：GitHub 新仓库默认分支名是main，不是master；老教程写master会失败）
最容易被忽略的是分支名变更——2020 年后新建的 GitHub 仓库默认用 main，但本地 git init 仍生成 master。所以首次 push 前，要么重命名本地分支：git branch -M main，要么在 push 时显式指定：git push -u origin main。否则你会收到 refusing to update checked out branch 或 non-fast-forward 报错，然后一头雾水。
