记录给 Vue 提交 PR 的过程,教给新手如何为开源库贡献代码

前言

最近想给自己的开源项目添加发布脚本,主要实现交互命令行,选择新版本类型 major/minor/patch → 自动修改 package.jsonversion → 执行测试 → 执行构建 → 生成 changelog → 提交本地 git → 发布到 npm → 创建 git 标签 → 代码推送到 GitHub。

然后我就想到 Vue 仓库里就有完整的 scripts/release.js,所谓站在巨人的肩膀上,在我把源码看完一遍之后,不出意外就是要出意外了,😊果然被我发现破绽了吧!

  1. test 命令写错了,虽然由于 pnpm 的特性不影响运行,但肯定更正一下更好。
  2. Vue release 脚本提供了 dry-run 模式,即尝试运行,不会真的发布,可根据打印的日志信息,让开发者核对发布的内容是否正确。由于脚本自动修改了 package.json,导致 pnpm publish --dry-run 的 git 检查过不去,这种保护机制是为了避免开发者遗漏了未提交的代码,实际上我们并没有修改源码,所以应该加上 --no-git-checks 禁用 git 检查。
  3. 第三处就是华为水 Linux PR 🤗最喜欢的单词拼写错误啦。

正题

第一步在 GitHub 上 fork 一份 Vue 的代码。

把 fork 的自己的仓库克隆到本地,建立一个新分支专门修复该问题,这也是 git 的正确使用方式,每个大功能和问题修复都建立单独的分支,并且规范分支命名,后续有问题回看的时候一目了然。新功能分支一般叫 feat/xxx,问题修复分支一般叫 fix/xxx,这里命名如下:

bash 复制代码
git checkout -b fix/scripts-release

然后咔咔把问题改好,将刚才创建的本地分支推送到 GitHub。这里需要注意的是,热门的开源仓库都比较规范,少不了代码格式、git 日志格式等等的校验,如果发现代码在本地提交不上,根据报错提示修改即可。

bash 复制代码
git push -u origin fix/scripts-release:fix/scripts-release

推荐用 VS Code 操作,git 命令记起来确实烦:

之后 GitHub 会自动提示你可以向源仓库提交 PR:

然后填写自己这次修复的详细说明,点击最下方的提交即可。

最后就是等待作者合并啦。有一说一,昨天看到 PR 被合并的邮件还是非常开心的~

写给开源新手的话

其实我第一次用 GitHub 的时候也是一脸懵逼,根本不知道放点什么上去,去改什么,怎么改,甚至有一次我错误地把同步别人的代码搞成了提交 PR,里面全是自己的测试代码,真是尴尬的要死。现在回头看,新手期真的不用着急,代码写多了,就会遇到 BUG,如果是用的开源包出了问题,还没人修复,这时就可以自然而然地动手去改并提交给作者了。

真要说参与开源社区的难点在哪,我真不觉得是技术,而是英语!不论是填写说明、求助、还是和别人讨论问题,我都会反复纠结这句话语法对不对,语气是不是礼貌......大家一定要学好英语啊😭。

相关推荐
企业对冲系统官1 小时前
大宗商品风险对冲系统统计分析功能的技术实现
运维·python·算法·区块链·github·pygame
xkxnq2 小时前
第二阶段:Vue 组件化开发(第 28天)
前端·javascript·vue.js
zhengxianyi5153 小时前
vue-cli build, vite build 生产部署刷新或弹窗404,页面空白修复方法
前端·javascript·vue.js·nginx·生产部署
恋爱绝缘体13 小时前
Vue.js 组件 - 自定义事件【1】
前端·javascript·vue.js
做cv的小昊4 小时前
3DGS加速&压缩指标评测方法、高斯数量变化曲线绘制——Training Time、FPS、Gaussian Number、Peak Memory
笔记·计算机视觉·3d·开源·github·图形渲染·3dgs
zhengxianyi5155 小时前
vite build 发布到nginx二级目录——将yudao-ui-go-view打包、部署到big目录下
vue.js·nginx·vite·前后端分离·打包·ruoyi-vue-pro优化·部署运维
huangyiyi666666 小时前
前端-远程多选搜索框不能反显的问题解决
前端·javascript·vue.js·笔记·学习
敲敲了个代码6 小时前
让 Vant 弹出层适配 Uniapp Webview 返回键
前端·javascript·vue.js·学习·面试·uni-app
+VX:Fegn08956 小时前
计算机毕业设计|基于springboot + vue校园跑腿系统(源码+数据库+文档)
数据库·vue.js·spring boot·后端·课程设计
CoderJia程序员甲6 小时前
GitHub 热榜项目 - 日榜(20260116)
ai·开源·大模型·github·ai教程