文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载git push是 Git 日常协作中使用频率最高的命令之一。本文以 tldr 仓库 中阿拉伯语文档页 pages.ar/common/git-push.md 为骨架完整讲解其收录的 8 种推送场景并结合仓库中的英文源页、样式规范与翻译模板说明这张速查页如何在多语言客户端中正确呈现。读完本文你将掌握从无参数推送到按需删除远端分支的完整git push实战用法并理解 tldr 速查页的标准化写作与翻译机制。一、速查页定位git push 在 tldr 中的文档形态tldrToo Long; Didnt Read项目的目标是提供比man手册更简洁、面向实操的命令速查。项目 README 中明确说明仓库是针对最常用 UNIX、Linux、macOS 等平台命令行工具持续增长的示例集合见 README.md。git push的速查页存放在两个位置英文源页pages/common/git-push.md阿拉伯语翻译页pages.ar/common/git-push.md本文关联文档在 tldr 的目录体系里common表示该命令在各平台行为一致、适用于所有用户而带语言后缀的pages.ar目录存放阿拉伯语翻译。项目主命令页 pages.ar/common/git.md 的简介也明确写着commit、add、branch、checkout、push等子命令各有独立文档页这正是指向git-push.md这类子命令页的导航方式。二、阿拉伯语速查页内容全览八种推送场景pages.ar/common/git-push.md 以# git push为标题简介行为 دفع التعديلات إلى مستودع Git خارجي.将本地修改推送到外部 Git 仓库并附官方文档链接https://git-scm.com/docs/git-push。全页收录 8 个示例覆盖了日常 Git 协作的主要推送需求逐条整理如下1. 默认推送将当前分支的本地修改推送到远端对应分支git push阿拉伯语描述دفع التعديلات المحلية في الفرع الحالي إلى نظيره في المستودع الخارجي推送当前分支的本地修改到其在外部仓库中的对应分支。不带任何参数时Git 会依据该分支配置的 upstream上游分支将本地提交推送到远端对应分支若尚未设置上游且未配置push.default为简单模式Git 会提示用户设置跟踪关系。2. 指定远端与本地分支推送git push {{remote_name}} {{local_branch}}描述为دفع التعديلات من فرع محلي معين إلى نظيره في المستودع الخارجي将指定本地分支的修改推送到外部仓库中对应的分支。这里{{remote_name}}指远端名称通常为origin{{local_branch}}为本地分支名。注意占位符{{ }}语法是 tldr 的标准化标记客户端会将其高亮以提示用户替换为实际值。3. 推送并设置上游跟踪git push {{[-u|--set-upstream]}} {{remote_name}} {{local_branch}}描述为推送指定本地分支的修改到外部仓库对应分支并将远端分支设为该本地分支日后 push/pull 的默认目标。{{[-u|--set-upstream]}}是 tldr 的选项占位符写法表示客户端可以自由选择显示短选项-u或长选项--set-upstream。-u会在推送同时建立 upstream 跟踪关系此后直接执行git push即可推到该远端分支。4. 推送本地分支到指定的远端分支git push {{remote_name}} {{local_branch}}:{{remote_branch}}描述为将指定本地分支的修改推送到外部仓库中一个特定分支。冒号语法本地分支:远端分支允许推送时改名例如将本地feature分支推送到远端main即git push origin feature:main。这种写法在修复远端分支命名或做临时推送时非常实用。5. 推送全部分支git push --all {{remote_name}}描述为将所有本地分支的修改推送到外部仓库中的对应分支。--all会将本地全部分支一次推送到指定远端。需要注意--all是批量操作在多分支项目中使用时建议先确认远端状态。6. 删除远端分支git push {{remote_name}} {{[-d|--delete]}} {{remote_branch}}描述为从外部仓库中删除一个特定分支。{{[-d|--delete]}}同样是长短选项占位符。删除远端分支等价于推送一个空引用git push origin --delete feature会删除远端feature分支。此操作不可逆属于 tldr 样式指南中要求谨慎书写的那类破坏性命令。7. 修剪无对应本地分支的远端分支git push --prune {{remote_name}}描述为删除外部仓库中已不再有本地对应分支的远端分支。--prune会移除远端已删除但本地跟踪引用中仍残留的分支信息常用于清理长期协作后遗留的过期远端分支引用。8. 发布本地标签git push --tags描述为发布外部仓库中尚不存在的标签tags。--tags将本地所有尚未存在于远端的标签推送上去。需要注意它不会删除或更新远端的同名标签更新标签需要--force因此常用于发布新版本后同步标签。三、结合仓库源码与规范速查页的写作与翻译机制tldr 的每张速查页都必须符合严格格式规范git-push.md正是规范约束下的产物。核心规则来自 contributing-guides/style-guide.md通用模板每页以# 命令名开头接简介行、 More information: 链接行然后是若干描述 命令对每页最多 8 个示例。阿拉伯语版同样遵循此模板见 contributing-guides/style-guide.ar.md。占位符语法用户需替换的值统一用{{placeholder}}包裹客户端据此高亮{{[-u|--set-upstream]}}这类选项占位符允许客户端按用户偏好展示短或长选项见 contributing-guides/style-guide.md。示例描述必须使用祈使句阿拉伯语规范亦强调描述采用命令式而非叙述式见 contributing-guides/style-guide.ar.md。规范校验工具贡献者可用npm install --global tldr-lint tldr-lint path/to/tldr_page.md本地校验格式仓库 CI 也会在每个 Pull Request 上自动执行见 contributing-guides/style-guide.md。关于占位符的翻译contributing-guides/translation-templates/common-arguments.md 中有一条专门针对阿拉伯语的硬性规则阿拉伯语ar和波斯语fa页面中的占位符不应翻译以避免 RTL从右到左文字在阅读时产生翻转错乱。这解释了为何 pages.ar/common/git-push.md 中的{{remote_name}}、{{local_branch}}、{{remote_branch}}均保持英文原样。在项目工程侧多语言页面的维护有配套脚本支撑。例如 scripts/set-page-title.py 提供-S/--sync选项可把英文页标题同步到所有语言翻译页并支持-l pt_BR指定单一语言见 scripts/set-page-title.py。这保证了git push这类跨语言页面的标题一致性。四、英文源页与阿拉伯语页的对应关系将 pages/common/git-push.md英文源页与 pages.ar/common/git-push.md阿拉伯语页逐条对照可以看到 8 个示例一一对应描述与命令完全等量仅语言不同#命令示例英文描述阿拉伯语描述1git pushSend local changes in the current branch to its default remote counterpartدفع التعديلات المحلية في الفرع الحالي إلى نظيره في المستودع الخارجي2git push {{remote_name}} {{local_branch}}Send changes from a specific local branch to its remote counterpartدفع التعديلات من فرع محلي معين إلى نظيره في المستودع الخارجي3git push {{[-u\|--set-upstream]}} {{remote_name}} {{local_branch}}Send changes ... and set the remote one as the default push/pull target... وتعيين الفرع الخارجي كهدف افتراضي لعمليات الدفع والسحب4git push {{remote_name}} {{local_branch}}:{{remote_branch}}Send changes from a specific local branch to a specific remote branchدفع التعديلات من فرع محلي معين إلى فرع خارجي محدد5git push --all {{remote_name}}Send changes on all local branches to their counterparts in a given remoteدفع جميع الفروع المحلية إلى نظائرها في المستودع الخارجي6git push {{remote_name}} {{[-d\|--delete]}} {{remote_branch}}Delete a branch in a remote repositoryحذف فرع معين من المستودع الخارجي7git push --prune {{remote_name}}Remove remote branches that dont have a local counterpartحذف الفروع البعيدة التي لا تمتلك نظيرًا محليًا بعد الآن8git push --tagsPublish tags that arent yet in the remote repositoryنشر العلامات (tags) غير الموجودة في المستودع الخارجي两页都严格保持标题—简介—More information 链接—8 个示例的结构符合 tldr 最多 8 个示例的容量上限要求。五、实操要点与注意事项结合速查页内容在实际使用git push时建议关注以下要点首次推送务必使用-ugit push -u origin main建立 upstream 后后续提交只需git push即可这也是速查页将-u/--set-upstream单独列为一条示例的原因。删除远端分支属于破坏性操作执行git push origin --delete 分支前应确认远端分支已合并或被备份tldr 样式指南也要求对破坏性命令使用防误复制的占位符写法如{{/dev/sdXY}}类模式见 contributing-guides/style-guide.md。--prune是清理利器在多人协作、分支频繁合并删除的场景下定期执行git push --prune origin可避免本地残留大量已失效的远端跟踪引用。--tags只会推送新标签若需要强制更新远端同名标签需显式加--force此时务必谨慎避免覆盖他人已发布的版本标记。命令成功与否可查看返回提示推送成功后 Git 会输出To 远端地址及分支更新摘要失败时常见于远端有本地缺失的提交需先git pull或权限不足。六、小结pages.ar/common/git-push.md 是一张结构标准、覆盖完整实战场景的git push速查页8 个示例从最基础的默认推送到指定分支、设置上游、分支映射、全量推送再到删除分支、修剪引用和发布标签几乎涵盖了日常 Git 推送的所有高频需求。透过它与英文源页 pages/common/git-push.md、样式规范 contributing-guides/style-guide.md、阿拉伯语规范 contributing-guides/style-guide.ar.md 及占位符翻译规则 contributing-guides/translation-templates/common-arguments.md 的对照读者既能获得可直接复制的git push命令也能理解 tldr 项目如何通过标准化模板、lint 校验与翻译约定将每一条命令行知识可靠地交付给全球不同语言的使用者。赞分享文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载相关推荐tldr 仓库的 gcc 命令速查页覆盖编译、优化与链接的 8 个核心场景tldr 仓库的 gcc 命令速查页覆盖编译、优化与链接的 8 个核心场景 gcc GNU Compiler Collection是 Linux、macO文档教程知识库ASH-XIIX 键盘 QMK 固件完全指南面向 Cherry G80-1800 外壳的 1800 布局移植与配置解析ASH XIIX 键盘 QMK 固件完全指南面向 Cherry G80 1800 外壳的 1800 布局移植与配置解析 本篇技术指南围绕 QMK Firmwa文档教程知识库tldr-pages 仓库中的 du 命令速查页磁盘空间占用的 7 个实战用法详解tldr pages 仓库中的 du 命令速查页磁盘空间占用的 7 个实战用法详解 du disk usage是 GNU coreutils 中用于估计文档教程知识库上一篇微信红包助手实战指南自动抢红包不拼手速10 分钟配置到位还不露馅下一篇闲鱼自动化工具实测每天省下半小时自动签到、擦亮、统计一次搞定创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
tldr 项目中的 git push 命令速查页详解：八种推送场景与仓库实现
文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载git push是 Git 日常协作中使用频率最高的命令之一。本文以 tldr 仓库 中阿拉伯语文档页 pages.ar/common/git-push.md 为骨架完整讲解其收录的 8 种推送场景并结合仓库中的英文源页、样式规范与翻译模板说明这张速查页如何在多语言客户端中正确呈现。读完本文你将掌握从无参数推送到按需删除远端分支的完整git push实战用法并理解 tldr 速查页的标准化写作与翻译机制。一、速查页定位git push 在 tldr 中的文档形态tldrToo Long; Didnt Read项目的目标是提供比man手册更简洁、面向实操的命令速查。项目 README 中明确说明仓库是针对最常用 UNIX、Linux、macOS 等平台命令行工具持续增长的示例集合见 README.md。git push的速查页存放在两个位置英文源页pages/common/git-push.md阿拉伯语翻译页pages.ar/common/git-push.md本文关联文档在 tldr 的目录体系里common表示该命令在各平台行为一致、适用于所有用户而带语言后缀的pages.ar目录存放阿拉伯语翻译。项目主命令页 pages.ar/common/git.md 的简介也明确写着commit、add、branch、checkout、push等子命令各有独立文档页这正是指向git-push.md这类子命令页的导航方式。二、阿拉伯语速查页内容全览八种推送场景pages.ar/common/git-push.md 以# git push为标题简介行为 دفع التعديلات إلى مستودع Git خارجي.将本地修改推送到外部 Git 仓库并附官方文档链接https://git-scm.com/docs/git-push。全页收录 8 个示例覆盖了日常 Git 协作的主要推送需求逐条整理如下1. 默认推送将当前分支的本地修改推送到远端对应分支git push阿拉伯语描述دفع التعديلات المحلية في الفرع الحالي إلى نظيره في المستودع الخارجي推送当前分支的本地修改到其在外部仓库中的对应分支。不带任何参数时Git 会依据该分支配置的 upstream上游分支将本地提交推送到远端对应分支若尚未设置上游且未配置push.default为简单模式Git 会提示用户设置跟踪关系。2. 指定远端与本地分支推送git push {{remote_name}} {{local_branch}}描述为دفع التعديلات من فرع محلي معين إلى نظيره في المستودع الخارجي将指定本地分支的修改推送到外部仓库中对应的分支。这里{{remote_name}}指远端名称通常为origin{{local_branch}}为本地分支名。注意占位符{{ }}语法是 tldr 的标准化标记客户端会将其高亮以提示用户替换为实际值。3. 推送并设置上游跟踪git push {{[-u|--set-upstream]}} {{remote_name}} {{local_branch}}描述为推送指定本地分支的修改到外部仓库对应分支并将远端分支设为该本地分支日后 push/pull 的默认目标。{{[-u|--set-upstream]}}是 tldr 的选项占位符写法表示客户端可以自由选择显示短选项-u或长选项--set-upstream。-u会在推送同时建立 upstream 跟踪关系此后直接执行git push即可推到该远端分支。4. 推送本地分支到指定的远端分支git push {{remote_name}} {{local_branch}}:{{remote_branch}}描述为将指定本地分支的修改推送到外部仓库中一个特定分支。冒号语法本地分支:远端分支允许推送时改名例如将本地feature分支推送到远端main即git push origin feature:main。这种写法在修复远端分支命名或做临时推送时非常实用。5. 推送全部分支git push --all {{remote_name}}描述为将所有本地分支的修改推送到外部仓库中的对应分支。--all会将本地全部分支一次推送到指定远端。需要注意--all是批量操作在多分支项目中使用时建议先确认远端状态。6. 删除远端分支git push {{remote_name}} {{[-d|--delete]}} {{remote_branch}}描述为从外部仓库中删除一个特定分支。{{[-d|--delete]}}同样是长短选项占位符。删除远端分支等价于推送一个空引用git push origin --delete feature会删除远端feature分支。此操作不可逆属于 tldr 样式指南中要求谨慎书写的那类破坏性命令。7. 修剪无对应本地分支的远端分支git push --prune {{remote_name}}描述为删除外部仓库中已不再有本地对应分支的远端分支。--prune会移除远端已删除但本地跟踪引用中仍残留的分支信息常用于清理长期协作后遗留的过期远端分支引用。8. 发布本地标签git push --tags描述为发布外部仓库中尚不存在的标签tags。--tags将本地所有尚未存在于远端的标签推送上去。需要注意它不会删除或更新远端的同名标签更新标签需要--force因此常用于发布新版本后同步标签。三、结合仓库源码与规范速查页的写作与翻译机制tldr 的每张速查页都必须符合严格格式规范git-push.md正是规范约束下的产物。核心规则来自 contributing-guides/style-guide.md通用模板每页以# 命令名开头接简介行、 More information: 链接行然后是若干描述 命令对每页最多 8 个示例。阿拉伯语版同样遵循此模板见 contributing-guides/style-guide.ar.md。占位符语法用户需替换的值统一用{{placeholder}}包裹客户端据此高亮{{[-u|--set-upstream]}}这类选项占位符允许客户端按用户偏好展示短或长选项见 contributing-guides/style-guide.md。示例描述必须使用祈使句阿拉伯语规范亦强调描述采用命令式而非叙述式见 contributing-guides/style-guide.ar.md。规范校验工具贡献者可用npm install --global tldr-lint tldr-lint path/to/tldr_page.md本地校验格式仓库 CI 也会在每个 Pull Request 上自动执行见 contributing-guides/style-guide.md。关于占位符的翻译contributing-guides/translation-templates/common-arguments.md 中有一条专门针对阿拉伯语的硬性规则阿拉伯语ar和波斯语fa页面中的占位符不应翻译以避免 RTL从右到左文字在阅读时产生翻转错乱。这解释了为何 pages.ar/common/git-push.md 中的{{remote_name}}、{{local_branch}}、{{remote_branch}}均保持英文原样。在项目工程侧多语言页面的维护有配套脚本支撑。例如 scripts/set-page-title.py 提供-S/--sync选项可把英文页标题同步到所有语言翻译页并支持-l pt_BR指定单一语言见 scripts/set-page-title.py。这保证了git push这类跨语言页面的标题一致性。四、英文源页与阿拉伯语页的对应关系将 pages/common/git-push.md英文源页与 pages.ar/common/git-push.md阿拉伯语页逐条对照可以看到 8 个示例一一对应描述与命令完全等量仅语言不同#命令示例英文描述阿拉伯语描述1git pushSend local changes in the current branch to its default remote counterpartدفع التعديلات المحلية في الفرع الحالي إلى نظيره في المستودع الخارجي2git push {{remote_name}} {{local_branch}}Send changes from a specific local branch to its remote counterpartدفع التعديلات من فرع محلي معين إلى نظيره في المستودع الخارجي3git push {{[-u\|--set-upstream]}} {{remote_name}} {{local_branch}}Send changes ... and set the remote one as the default push/pull target... وتعيين الفرع الخارجي كهدف افتراضي لعمليات الدفع والسحب4git push {{remote_name}} {{local_branch}}:{{remote_branch}}Send changes from a specific local branch to a specific remote branchدفع التعديلات من فرع محلي معين إلى فرع خارجي محدد5git push --all {{remote_name}}Send changes on all local branches to their counterparts in a given remoteدفع جميع الفروع المحلية إلى نظائرها في المستودع الخارجي6git push {{remote_name}} {{[-d\|--delete]}} {{remote_branch}}Delete a branch in a remote repositoryحذف فرع معين من المستودع الخارجي7git push --prune {{remote_name}}Remove remote branches that dont have a local counterpartحذف الفروع البعيدة التي لا تمتلك نظيرًا محليًا بعد الآن8git push --tagsPublish tags that arent yet in the remote repositoryنشر العلامات (tags) غير الموجودة في المستودع الخارجي两页都严格保持标题—简介—More information 链接—8 个示例的结构符合 tldr 最多 8 个示例的容量上限要求。五、实操要点与注意事项结合速查页内容在实际使用git push时建议关注以下要点首次推送务必使用-ugit push -u origin main建立 upstream 后后续提交只需git push即可这也是速查页将-u/--set-upstream单独列为一条示例的原因。删除远端分支属于破坏性操作执行git push origin --delete 分支前应确认远端分支已合并或被备份tldr 样式指南也要求对破坏性命令使用防误复制的占位符写法如{{/dev/sdXY}}类模式见 contributing-guides/style-guide.md。--prune是清理利器在多人协作、分支频繁合并删除的场景下定期执行git push --prune origin可避免本地残留大量已失效的远端跟踪引用。--tags只会推送新标签若需要强制更新远端同名标签需显式加--force此时务必谨慎避免覆盖他人已发布的版本标记。命令成功与否可查看返回提示推送成功后 Git 会输出To 远端地址及分支更新摘要失败时常见于远端有本地缺失的提交需先git pull或权限不足。六、小结pages.ar/common/git-push.md 是一张结构标准、覆盖完整实战场景的git push速查页8 个示例从最基础的默认推送到指定分支、设置上游、分支映射、全量推送再到删除分支、修剪引用和发布标签几乎涵盖了日常 Git 推送的所有高频需求。透过它与英文源页 pages/common/git-push.md、样式规范 contributing-guides/style-guide.md、阿拉伯语规范 contributing-guides/style-guide.ar.md 及占位符翻译规则 contributing-guides/translation-templates/common-arguments.md 的对照读者既能获得可直接复制的git push命令也能理解 tldr 项目如何通过标准化模板、lint 校验与翻译约定将每一条命令行知识可靠地交付给全球不同语言的使用者。赞分享文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载相关推荐tldr 仓库的 gcc 命令速查页覆盖编译、优化与链接的 8 个核心场景tldr 仓库的 gcc 命令速查页覆盖编译、优化与链接的 8 个核心场景 gcc GNU Compiler Collection是 Linux、macO文档教程知识库ASH-XIIX 键盘 QMK 固件完全指南面向 Cherry G80-1800 外壳的 1800 布局移植与配置解析ASH XIIX 键盘 QMK 固件完全指南面向 Cherry G80 1800 外壳的 1800 布局移植与配置解析 本篇技术指南围绕 QMK Firmwa文档教程知识库tldr-pages 仓库中的 du 命令速查页磁盘空间占用的 7 个实战用法详解tldr pages 仓库中的 du 命令速查页磁盘空间占用的 7 个实战用法详解 du disk usage是 GNU coreutils 中用于估计文档教程知识库上一篇微信红包助手实战指南自动抢红包不拼手速10 分钟配置到位还不露馅下一篇闲鱼自动化工具实测每天省下半小时自动签到、擦亮、统计一次搞定创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
