一、本地操作

一、 环境准备与全局配置

在开始之前,需要确保本地已安装 Git。

首先需要告知 Git 你是谁,下面的指令会记录在每一次提交(Commit)中。

# 设置全局用户名和邮箱
git config --global user.name "你的用户名"
git config --global user.email "你的注册邮箱"

# 查看配置是否成功
git config --list

二、 建立安全连接 (SSH Key)

为了不必每次推送都输入账号密码,推荐使用 SSH 密钥对进行身份验证。

  1. 生成密钥对

    ssh-keygen -t rsa -b 4096 -C "你的邮箱"
    # 按三次回车(默认路径,不设密码)
  2. 获取公钥:
    查看并复制 /Users/你的用户名/.ssh/id_rsa.pub 文件中的全部内容。(如果第一步复制粘贴了路径并回车,要去复制的路径下照)

  3. 配置到 GitHub:
    登录 GitHub -> Settings -> SSH and GPG keys -> New SSH key,将内容粘贴进去。

  4. 测试连接:

    ssh -T git@github.com
    # 看到 "Hi [你的用户名]! You've successfully authenticated" 即表示成功

三、 创建与初始化仓库

1.将本地现有项目上传 GitHub

  1. 进入项目目录:cd your_project

  2. 初始化 Git:git init

  3. 关联远程仓库:

    git remote add origin git@github.com:用户名/仓库名.git

2.克隆云端已有项目到本地

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

四、 日常开发核心流水线

1. 查看当前状态

确认哪些文件被修改了,哪些还没被追踪。

git status

2. 暂存修改 (Stage)

将工作区的修改提交到暂存区。

git add .          # 提交所有修改
git add file.py    # 仅提交指定文件

3. 本地提交 (Commit)

将暂存区的内容正式记录到本地仓库历史中。

git commit -m "这次修改的描述信息"

4. 同步远程代码 (Pull)

在 Push 之前,养成先拉取远程最新代码的习惯,防止冲突。

git pull origin main

5. 推送至 GitHub (Push)

git push origin main

五、 分支管理 (Branching)

为了保证主分支(main)的稳定,新功能应在独立分支开发。

  1. 创建并切换分支:

    git checkout -b feature-new-ui  # 创建并跳转到新分支
  2. 查看所有分支:

    git branch
  3. 合并分支:

    git checkout main               # 先切回主分支
    git merge feature-new-ui        # 将新功能合并进来
  4. 删除分支:

    git branch -d feature-new-ui

六、 避坑与进阶技巧

1. 使用 .gitignore

在项目根目录创建 .gitignore 文件,写上不需要上传的文件(如临时文件、密钥、大模型权重):

*.log
__pycache__/
.DS_Store
/checkpoints/

2. 撤销操作

  • 撤销 git add:git reset file.py

  • 修改最后一次 Commit 信息:git commit --amend

  • 强制回滚到某个版本:git reset --hard [commit_id]

3. 查看历史

git log --oneline --graph --all

二、公共服务器操作

一、 身份隔离:严禁修改全局配置

服务器上通常由多个开发者共用一个 Linux 用户(如 worker 或 root)。修改全局配置(--global)会导致所有人的提交记录都变成你的名字。

正确操作: 仅在当前项目目录下配置局部身份。

cd /path/to/your/project
git init
# 局部配置,仅对当前目录有效
git config user.name "xxx"
git config user.email "xxx@xx.com"

# 检查配置(确认没有 global 字样)
git config --local --list

二、 密钥安全:私钥权限与自定义路径

为了不覆盖服务器默认的 SSH 密钥(通常属于公共部署账号或前任开发者),建议将私钥存放在个人目录下。

1. 私钥权限锁定(关键)

Linux 系统要求私钥必须是私密的。如果权限太开放,SSH 会直接忽略该私钥。

# 必须设置为 600 权限(仅拥有者可读写)
chmod 600 /your/private/path/.ssh_key

2. 仓库 SSH 路径绑定

无需修改全局 SSH 配置,直接让 Git 记住该仓库专用的私钥:

# 在项目目录下执行,让当前仓库永远使用指定私钥
git config core.sshCommand "ssh -i /your/private/path/.ssh_key -o StrictHostKeyChecking=no"

三、  .gitignore

公共服务器磁盘空间大,但 Git 仓库忌讳大文件。绝对不能将模型权重(.pt/.pth)和测试视频推送到云端。在根目录创建 .gitignore 并写入:

# 忽略所有深度学习权重文件
*.pt
*.pth
*.ckpt
/checkpoints/
/output/

# 忽略大型数据集和媒体文件
*.mp4
*.wav
*.zip
*.tar.gz

# 忽略系统与环境文件
__pycache__/
.env
*.log
venv/

四、 远程同步操作流程

1. 关联个人仓库

# 建议先建立远程关联
git remote add origin git@github.com:YourName/Project.git

# 验证连接身份(确保返回的是你的名字而非同事)
GIT_SSH_COMMAND="ssh -i /path/to/key" ssh -T git@github.com

2. 推送代码

git add .
git commit -m "xxx"

# 推送本地 main 分支到远程
git push -u origin main

五、 项目隐私与成员管理

在公共服务器上开发的项目,通常涉及公司核心算法,建议在 GitHub/GitLab Web 端进行以下设置:

  1. Visibility(可见性):

    • 强烈建议设为 Private。防止公司外部或非项目组人员扫描到核心参数。

  2. 角色分配(Roles):

    • Reporter(报告者):仅允许对方查看和下载代码(适合导师指导)。

    • Developer(开发者):允许对方提交代码(适合合伙人协作)。

    • Maintainer(维护者):允许对方修改仓库设置和审批合并申请。


六、 常见问题排查 (Troubleshooting)

  • 报错 Permission denied:

    • 检查公钥是否已上传至 GitHub 网页端;

    • 确认 chmod 600 是否已执行;

    • 确认 core.sshCommand 路径是否正确。

  • 误传了大文件导致 Push 极慢:

    • 立即 Ctrl+C 中断;

    • 执行 git rm --cached <文件路径>;

    • 修改 .gitignore 后重新提交。

  • 识别身份为同事名字:

    • 检查当前目录 .git/config 中的 user.name 是否正确覆盖了全局配置。

Logo

openEuler 是由开放原子开源基金会孵化的全场景开源操作系统项目,面向数字基础设施四大核心场景(服务器、云计算、边缘计算、嵌入式),全面支持 ARM、x86、RISC-V、loongArch、PowerPC、SW-64 等多样性计算架构

更多推荐