Github操作,本地与公共服务器
一、本地操作
一、 环境准备与全局配置
在开始之前,需要确保本地已安装 Git。
首先需要告知 Git 你是谁,下面的指令会记录在每一次提交(Commit)中。
# 设置全局用户名和邮箱
git config --global user.name "你的用户名"
git config --global user.email "你的注册邮箱"
# 查看配置是否成功
git config --list
二、 建立安全连接 (SSH Key)
为了不必每次推送都输入账号密码,推荐使用 SSH 密钥对进行身份验证。
-
生成密钥对
ssh-keygen -t rsa -b 4096 -C "你的邮箱" # 按三次回车(默认路径,不设密码) -
获取公钥:
查看并复制 /Users/你的用户名/.ssh/id_rsa.pub 文件中的全部内容。(如果第一步复制粘贴了路径并回车,要去复制的路径下照) -
配置到 GitHub:
登录 GitHub -> Settings -> SSH and GPG keys -> New SSH key,将内容粘贴进去。 -
测试连接:
ssh -T git@github.com # 看到 "Hi [你的用户名]! You've successfully authenticated" 即表示成功
三、 创建与初始化仓库
1.将本地现有项目上传 GitHub
-
进入项目目录:cd your_project
-
初始化 Git:git init
-
关联远程仓库:
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)的稳定,新功能应在独立分支开发。
-
创建并切换分支:
git checkout -b feature-new-ui # 创建并跳转到新分支 -
查看所有分支:
git branch -
合并分支:
git checkout main # 先切回主分支 git merge feature-new-ui # 将新功能合并进来 -
删除分支:
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 端进行以下设置:
-
Visibility(可见性):
-
强烈建议设为 Private。防止公司外部或非项目组人员扫描到核心参数。
-
-
角色分配(Roles):
-
Reporter(报告者):仅允许对方查看和下载代码(适合导师指导)。
-
Developer(开发者):允许对方提交代码(适合合伙人协作)。
-
Maintainer(维护者):允许对方修改仓库设置和审批合并申请。
-
六、 常见问题排查 (Troubleshooting)
-
报错 Permission denied:
-
检查公钥是否已上传至 GitHub 网页端;
-
确认 chmod 600 是否已执行;
-
确认 core.sshCommand 路径是否正确。
-
-
误传了大文件导致 Push 极慢:
-
立即 Ctrl+C 中断;
-
执行 git rm --cached <文件路径>;
-
修改 .gitignore 后重新提交。
-
-
识别身份为同事名字:
-
检查当前目录 .git/config 中的 user.name 是否正确覆盖了全局配置。
-
openEuler 是由开放原子开源基金会孵化的全场景开源操作系统项目,面向数字基础设施四大核心场景(服务器、云计算、边缘计算、嵌入式),全面支持 ARM、x86、RISC-V、loongArch、PowerPC、SW-64 等多样性计算架构
更多推荐

所有评论(0)