如何创建 p5.js 拉取请求并处理模板填写与合并冲突【免费下载链接】p5.jsp5.js is a client-side JS platform that empowers artists, designers, students, and anyone to learn to code and express themselves creatively on the web. It is based on the core principles of Processing. Looking for p5.js 2.0? http://beta.p5js.org项目地址: https://gitcode.com/GitHub_Trending/p5/p5.js你在自己的 fork 里改完了 p5.js 的代码并提交了 commit现在要把这些改动合并回官方仓库——这一步通过 Pull RequestPR拉取请求完成PR 是请求官方 p5.js 仓库把你 fork 仓库中的改动拉取进它的提交历史。完成本文操作后你会得到一个已正确填写模板、无合并冲突、等待评审的 PR。前提条件均来自 contributor guidelines对应的 issue 必须已被批准实现。没有对应 issue、或 issue 尚未获批就提 PR该 PR 会在获批前被关闭。批准门槛bug 修复和现有功能增强需至少 1 名 area steward 或 maintainer 批准新功能请求需至少 2 名。不要插队如果某 issue 已指派给他人或他人已表示要贡献不要为同一 issue 提 PR否则会被关闭。本地环境需熟悉命令行、gitNode.js 至少 v18用node -v检查并已用npm ci装好依赖。在提 PR 之前npm test必须无错误通过开发过程中也建议频繁运行npm test确保没有破坏现有行为。新功能或功能增强还需在 PR 中包含单元测试。所有 commit 和 PR 必须通过 lint项目用 ESLint 强制代码规范可用文本编辑器的 ESLint 插件提前发现错误。推送分支并打开 pull request先在本地完成准备工作。克隆 fork 时git clone [git_url]把[git_url]换成你 fork 页面 Code 按钮里复制的 URL添加上游远程仓库git remote add upstream https://github.com/processing/p5.js确保依赖已安装npm ci并从main建了描述性分支名完成改动与 commit 后把新 commit 推送到你的 forkgit push -u origin [branch_name][branch_name]换成你实际的分支名。推送完成后有两种方式打开 PR终端输出里通常会带一个直接创建 PR 的链接点击即可打开你 fork 的仓库页面在文件列表上方的下拉框切换到你的分支点击 Contribute → Open pull request。访问官方 p5.js 仓库页面时也会出现 Compare pull request 按钮点击同样可以打开新 PR。填写 pull request 模板提交 PR 前必须填写项目预置的 PR 模板它包含标题、Resolves、Changes、Screenshots 和 PR Checklist 几个部分各部分要求如下Title标题简要描述本次改动做了什么避免笼统的表述。Resolves模板中有Resolves #[Add issue number here]这一行把[Add issue number here]替换成你解决的 issue 编号例如Resolves #1234。合并后该 issue 会自动关闭。如果这个 PR 只是部分解决、issue 合并后还应保持打开比如还有后续 PR把Resolves改成Addresses。Changes清楚描述本 PR 做的改动包括与评审相关的所有实现细节和决策。Screenshots of the change可选仅当改动涉及 p5.js 在 canvas 上的视觉渲染时才需要。注意要截的是示例 sketch 改动后的运行画面而不是文本编辑器的截图。PR Checklist把与你的改动相关的清单项中[ ]替换为[x]在 Preview 标签页可确认勾选效果可删除与本次改动无关的部分。模板中的三个默认清单项是npm run lintpassesInline reference is included / updatedUnit tests are included / updated全部填完后点击 Create pull request。创建后先核对三件事PR 打开后contributor guidelines 要求检查三处Commits 标签页里的 commit 数量应与你实际提交的次数一致提交了两次就应该只显示两个 commitFiles changed 标签页应只显示你相对于官方 p5.js 仓库做的改动没有多余内容页面下方应显示 This branch has no conflicts with the base branch.而不是 This branch has conflicts that must be resolved.。如果 commit 数量不对或出现冲突说明需要 rebase 或解决冲突处理流程见下一节。处理合并冲突冲突意味着你改过的文件在 main 分支上也近期有改动git 无法确定保留哪一边。p5.js 文档给出两条路径。在浏览器中直接解决有时 GitHub 会在 PR 页面显示 Resolve conflicts 按钮可以直接在浏览器里处理冲突代码位于和之间中间用分隔一侧是你的代码另一侧是 main 分支上的新改动。删除冲突标记只保留你希望进入 PR 的最终代码然后点 Mark as resolved。等所有存在冲突的文件都标记解决后提交这次变更界面上会启用 commit 按钮。在本地用 rebase 解决冲突太复杂导致 GitHub 网页无法展示或你更喜欢手动处理时在本地执行git remote add upstream https://github.com/processing/p5.js git fetch upstream git rebase upstream/mainrebase 后可能产生冲突。文档给出的判断方法如果冲突只出现在lib/p5.js和lib/p5.min.js直接重新构建项目即可解决其他文件的冲突如果不确定如何解决文档建议在 issue/PR 里求助。解决冲突后运行npm test git add -u git rebase --continue最后执行git push把结果推回 fork。执行上述步骤后 PR 的冲突提示通常会清除如果没有清除文档说明维护者会进一步指导。等待评审与追加 commitPR 打开后由 steward 或 maintainer 评审可能等几天才有人回复。评审后有两种结果PR 被批准并合并或者评审者提问或要求修改。需要修改时沿着 contributor guidelines 中 Git workflow 的流程继续在本地同一分支上改代码、commit、推送到 fork新 commit 会自动出现在 PR 里。推送后在 PR 里留一条评论告知评审者你已按请求修改若无更多改动PR 即会被合并。边界提醒未获 issue 批准、或抢占了已指派 issue 的 PR 会被关闭PR 必须通过 lint新功能/功能增强必须附带单元测试。这些规则详见 CONTRIBUTING.md 与 contributor_docs/contributor_guidelines.md。【免费下载链接】p5.jsp5.js is a client-side JS platform that empowers artists, designers, students, and anyone to learn to code and express themselves creatively on the web. It is based on the core principles of Processing. Looking for p5.js 2.0? http://beta.p5js.org项目地址: https://gitcode.com/GitHub_Trending/p5/p5.js创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考