在 MQL5 Algo Forge 中协作与合并更改
分叉项目 #
分叉(Forking)会在你自己的账户下创建一个他人存储库的个人版本。这为你提供了一个安全、独立的空间,让你能够在不干扰原始创建者代码库的情况下进行实验和更改。
在 MQL5 Algo Forge 网站上,您可以 探索公共项目 ,它们由世界各地的 MetaTrader 5 用户创建。找到喜欢的项目后,点击右上角的 “分叉”。

在分叉时,您可以输入不同的名称,选择要复制的分支,并编辑描述。点击“分叉仓库”。

新创建的存储库现在将显示在您的 MQL5 Algo Forge 帐户下。在 MetaEditor 中,刷新 Shared Projects 查看最近创建的分叉副本。要在本地开始处理项目文件,你需要先 克隆它。
克隆项目 #
克隆操作会将远程 MQL5 Algo Forge 存储库下载到您的本地计算机上。这将创建一个本地工作目录,您可以在其中编辑文件并提交更改,然后再将它们推送到远程仓库。
只有在 MQL5 Algo Forge 中拥有写入权限的存储库才能进行克隆。如果你想在本地计算机上处理公共项目中的文件,你需要先 对该项目进行分叉 ,然后克隆分叉后的副本。
在 MetaEditor 中,展开 “Shared Projects”,右键单击要克隆的项目,然后选择 “Git 克隆”。

创建合并请求 #
合并请求(拉取请求)是一种正式提议,用于审查已完成的独立分支工作并将其合并到目标分支中。它还作为一个讨论中心,合作者可以在这里检查、评论和测试你的代码,以确保在代码被接受之前一切正常。
以下是一些常见场景:
- 如果你在独立的项目分支中工作,你需要创建一个合并请求,将更改合并到主分支中。
- 如果你在分支副本的任何分支中工作,你需要创建一个合并请求,以将更改合并到原始项目的主分支中。项目的任何一位维护者都必须批准并接受该合并请求。
前往包含更改的仓库的网页,点击“合并请求”,然后点击“创建合并请求”按钮。

在“创建合并请求”页面上,选择要合并到的分支,然后选择要从中合并更改的分支。将重点突出所选两个分支之间的差异。点击“创建合并请求”按钮继续。

在下一页中,输入合并请求的名称、说明和其他详细信息。您可以添加标签和里程碑,将合并请求分配给特定人员,并控制维护者的编辑权限。

点击“创建合并请求”完成操作,合并请求将在该存储库中打开。
合并更改 #
合并是最后一步,它通过合并请求将包含更改的独立分支合并到目标代码库中。此操作需要写入权限,这意味着只有获得授权的项目维护者才能批准和合并请求。
在 MQL5 Algo Forge 网站上,打开您想要合并的请求。您可以导航到“提交”和“文件已更改”选项卡来研究和了解更改,然后返回到“对话”选项卡。

满意后,点击“创建合并提交”按钮,或者您也可以使用其他合并选项。
可用的合并选项及其作用:
- 创建合并提交:通过创建一个新的、专用的“合并提交”来合并分支,将两个分支的历史记录连接在一起。这样,图表中就会留下一个可见的循环,准确地显示分支的开始和结束时间。
- 重新设定基准,然后快进:首先将你分支的提交移动到目标分支的顶端,然后将目标分支指针向前移动。这会产生一个完全平坦、线性的历史记录,没有额外的合并提交。
- 先进行变基操作然后创建合并提交:首先将你分支的提交移动到目标分支的顶端,但在合并它们时仍然会生成最终的合并提交。这样既能保持历史记录的线性,又能明确记录合并的发生。
- 创建 squash 提交:将分支中的所有单独提交压缩成一个单独的、干净的提交,然后再将其添加到目标分支。这非常适合隐藏混乱的、增量式的进行中的工作提交。
- 仅快进:仅当目标分支自您开始工作以来未收到任何新更新时,才会合并更改。如果存在这种情况,合并将会失败,您将被迫先手动同步您的分支。
解决冲突 #
解决冲突需要您 使用外部 Git 客户端 或在终端中执行命令。
MetaEditor 中拉取或推送时发生冲突
当将本地更改推送到远程仓库或从远程仓库拉取更改到本地时,由于冲突,自动合并可能会失败。以下是典型的冲突情况,即相互竞争的更改已被推送到远程仓库:
- 内容冲突(编辑-编辑)。另一位在同一分支上工作的开发人员修改了你修改的同一行代码。
- 结构冲突(删除-修改)。同一分支上的另一个开发人员删除了或重命名了您编辑的文件。
- 二进制文件冲突。另一位在同一分支上工作的开发人员编辑了您之前编辑过的同一个二进制文件(例如图像或 PDF)。Git 无法逐行读取二进制文件,因此无法自动合并它们。
- 目录-文件冲突。在一个分支中,你或其他开发人员删除了一个文件,并创建了一个同名文件夹。在另一个分支中,有人继续将该文件作为独立项使用和编辑。
当在 MetaEditor 或其他工具中拉取更改时发生内容(编辑-编辑)冲突时,Git 会自动用视觉冲突标记(<<<<<<<、======= 和 >>>>>>>)将相互冲突的代码行包裹起来。
以下是解决外部 Git 客户端中基本冲突的典型步骤:
- 找到被标记的文件。打开 Git 客户端,找出冲突的文件。
- 决定如何解决冲突:
- 如果您的客户端支持内置的可视化合并功能,您可以选择保留哪个版本、接受两个更改,或者使用合并工具手动合并它们。按照提示解决冲突,然后继续执行步骤 4。
- 如果你希望文件同时包含两个版本的元素,或者更倾向于自己编辑文件,请在文本编辑器或集成开发环境中打开它。找到相互冲突的代码行周围的冲突标记,然后继续执行步骤 3。
- 清理并保存。手动编辑冲突的代码块,使文件包含您想要的最终版本。移除冲突标记和任何不需要的代码,然后保存文件。
- 准备并提交。您的 Git 客户端应该能够检测到文件已被修改。将文件暂存(或标记为已解决),然后提交更改以完成并关闭合并过程。
- 推送到远程。将新提交的合并结果发送到远程分支。
在 MQL5 Algo Forge 网站上合并时出现冲突
在 MQL5 Algo Forge 网站上将一个分支合并到另一个分支时,您也可能会遇到 Git 冲突。在这种情况下,你也必须 使用外部 Git 客户端 或者使用计算机上的命令行工具执行以下操作:
- 请将本地存储库更新至最新版本。打开本地 Git 客户端,从远程仓库获取最新更新,然后切换到要合并的目标分支。
- 在本地重现冲突。在你的 Git 客户端中发起相同的合并操作。这应该会产生与阻止 MQL5 Algo Forge 网站上的合并相同的冲突。
- 决定如何解决冲突。在任何文本编辑器或集成开发环境中打开受影响的文件。找到冲突标记,手动编辑代码以合并或选择正确的更改,完全删除标记,然后保存文件。
- 准备并提交。在 Git 客户端中暂存已解决的文件,以将其标记为已修复。提交更改以正式完成合并。
- 推送到远程。将新提交的合并决议发送回远程分支。MQL5 Algo Forge 网站会自动检测到冲突已解决,现在您可以执行合并操作。