与您的 GitHub 存储库双向同步

将您自己的 GitHub 账户连接到网站，我们将保持两者双向同步。此功能免费，默认处于关闭状态，直至您将其开启，并且我们仅会提交至您拥有的账户下的存储库——绝不会是我们的存储库。

哪些内容会被同步

无论您通过何种方式更改网站文件（文件管理器、SFTP、WordPress 主题编辑器或 SSH 会话），所做的任何更改都会成为存储库中的一次提交。您无需通知我们——我们会将您的网站与其最新提交进行比对并推送差异。

反方向亦然，向已连接分支推送的内容将直接同步至网站。

我们绝不提交的内容

您的 wp-config.php 会被永久且特意排除在外。它包含您的数据库密码和身份验证密钥，这些内容绝不应存放在存储库中——即使是私有存储库也不行，因为 git 会永久保留历史记录。

同样排除在外的还有：.env 文件、密钥与证书、您的上传文件夹、缓存以及 node_modules。存储库是您网站的源码，而不是备份。媒体文件应归入您的备份中，它们本就保存在那里；将其放入存储库会导致每次推送变慢，并使每次更改难以阅读。

如果两端均发生更改会怎样

这是个值得阅读的问题。假设您在文件管理器中编辑了一个文件，与此同时一位同事向同一个存储库推送了更改。

我们会暂停。我们不会执行合并，也不会覆盖任何人的内容。网站的 Deploy 选项卡会显示 "您的存储库存在未同步的更改"，指出您需要查看的提交，并等待您的操作。在等待期间，任何一方的内容都不会丢失——您的编辑仍保留在网站上，他们的提交仍保留在存储库中。

然后您可以选择：

• 保留此网站的文件——我们将您的版本置于他们的版本之上。他们的提交会保留在历史记录中；不会抹去任何内容。
• 使用存储库，放弃网站更改——存储库的版本将应用到网站，您在此处所做的更改将被放弃。此操作具有破坏性，因此需要明确点击确认，绝非我们会代您执行的操作。

故意未提供“自动合并”选项。由我们执行的合并可能会在生产网站上生成一份你们双方均未编写过、且在生效前双方都未审阅过的文件。

同步可能停止的原因

• 您尚未连接自己的 GitHub 账户。在您连接之前，该开关将保持关闭状态。
• 它正在等待您的操作。见上文——挂起状态不会自行解除。
• 您的账户状态异常。一旦账单更新完毕，同步将自动暂停并恢复。不会丢失任何内容。

Deploy 选项卡会显示最近几次同步，包括未发生更改的记录。如果该列表为空且同步已开启，则已连接的账户极有可能无法向存储库写入——请检查其访问权限并重新连接。

选择要同步的内容

默认情况下会同步整个网站。在 WordPress 网站上，这通常不是您想要的结果：这意味着会包含 WordPress 核心的每个文件，而这些文件并非由您编写，您也不会去编辑。将“仅同步此文件夹”设置为您的主题——例如 wp-content/themes/my-theme——其余部分便不会受到干扰。