下载 LibreCAD 并创建个人分支的 Git 操作指南
方法1:标准 Fork 工作流(推荐)
1. 在 GitHub 上 Fork 项目
首先访问 LibreCAD 官方仓库:
https://github.com/LibreCAD/LibreCAD
点击右上角的 “Fork” 按钮,创建自己的副本。
2. 克隆 Fork 到本地
git clone https://github.com/你的用户名/LibreCAD.git
cd LibreCAD
3. 添加上游远程仓库
git remote add upstream https://github.com/LibreCAD/LibreCAD.git
验证远程仓库设置:
git remote -v
输出应该类似:
origin https://github.com/你的用户名/LibreCAD.git (fetch)
origin https://github.com/你的用户名/LibreCAD.git (push)
upstream https://github.com/LibreCAD/LibreCAD.git (fetch)
upstream https://github.com/LibreCAD/LibreCAD.git (push)
4. 创建并切换到新分支
# 基于上游主分支创建新分支
git fetch upstream
git checkout -b 我的特性分支 upstream/master
方法2:直接克隆并创建分支
1. 直接克隆官方仓库
git clone https://github.com/LibreCAD/LibreCAD.git
cd LibreCAD
2. 创建并切换到新分支
git checkout -b 我的开发分支
分支命名建议
使用有意义的命名:
# 特性开发
git checkout -b feature/新功能名称# 修复bug
git checkout -b fix/问题描述# 文档改进
git checkout -b docs/文档类型# 实验性功能
git checkout -b experiment/实验名称
验证分支状态
# 查看当前分支
git branch# 查看所有分支(包括远程)
git branch -a# 查看分支与上游的关系
git status
保持分支与上游同步
从上游获取最新更改
# 获取上游所有更新
git fetch upstream# 合并上游主分支到你的分支
git merge upstream/master# 或者使用 rebase(保持历史整洁)
git rebase upstream/master
提交你的更改
# 添加更改的文件
git add .# 提交更改
git commit -m "描述你的更改"# 推送到你的 Fork
git push origin 你的分支名称
创建 Pull Request
- 访问你的 GitHub Fork 页面
- 点击 “Pull Request”
- 选择正确的分支
- 填写详细的描述信息
常用工作流命令总结
# 日常开发循环
git status # 检查状态
git add <文件> # 添加文件
git commit -m "描述" # 提交更改
git push origin 分支名 # 推送到远程# 同步上游更改
git fetch upstream # 获取上游更新
git merge upstream/master # 合并到当前分支# 解决冲突后
git add . # 标记冲突已解决
git commit # 完成合并提交
高级技巧
1. 使用分支描述
git config branch.你的分支名称.description "分支功能描述"
2. 设置上游跟踪分支
git branch -u upstream/master
3. 清理已合并的分支
# 删除本地已合并的分支
git branch --merged | grep -v "\*" | xargs -n 1 git branch -d# 删除远程已合并的分支
git push origin --delete 分支名
注意事项
- 定期同步:经常从上游仓库拉取更新,避免冲突积累
- 提交信息:编写清晰、有意义的提交信息
- 分支策略:为不同的工作创建独立的分支
- 备份重要工作:在重大更改前创建备份分支
验证设置
完成所有步骤后,验证你的设置:
# 检查远程仓库
git remote -v# 检查当前分支
git branch -v# 检查与上游的差异
git log --oneline HEAD..upstream/master
这样就成功创建了自己的 LibreCAD 开发分支,可以开始进行个性化开发了!