文档教程知识库【免费下载链接】til:memo: Today I Learned项目地址https://gitcode.com/gh_mirrors/ti/til点击查看免费下载本篇技术指南基于 jj/describe-current-changes-and-create-new-change.md 展开讲解 Jujutsujj中最常用的一个工作流模式给当前工作副本的变更添加描述相当于提交随即开启一条全新的变更change继续开发。读完本文你将掌握jj describejj new的组合用法、用jj commit一步完成同一件事的简写方式以及该简写仅在何种前提下成立——并能在实际开发中直接套用。背景在 jj 中工作副本本身就是一条 change在 jj 的版本控制模型里工作副本并不是游离于历史之外的未提交状态它本身就是一条变更change。你可以把它理解为你永远都站在某一条 change 之上工作区里的所有改动都属于当前这条 change。这一点与 Git 有明显差异——Git 需要显式的git add暂存再git commit固化而 jj 中不存在暂存区概念改动天然归属于当前 change你需要的只是给它一个描述并决定何时开启下一条 change。仓库中另一篇 jj/colocate-jj-and-git-directories-for-project.md 也佐证了这一点jj git clone会在项目下创建.jj目录存放版本控制信息且可用--colocate让.jj与.git同时存在、jj与git命令混用。如果你刚从 Git 迁移过来这套change 即一切的模型正是理解 jj 工作流的关键前提。核心模式jj describe描述当前变更jj new开启新变更刚克隆或新建仓库时当前 change 的描述是(no description)。当你在工作副本里做完一批改动、准备固化这批成果时典型做法是两句话$ jj describe -m Add status subcommand to show current status $ jj new逐步拆解jj describe为当前 change 添加描述信息。-m--message直接以内联参数给出描述文本免去打开编辑器不带-m时会打开你的默认编辑器撰写多行描述。jj new基于当前 change 创建一条新的 change并把新 change 设置为新的工作副本。此后你修改的文件就归属于这条新 change其描述同样是(no description)而刚被描述过的那条 change 则永久沉淀在历史中。两者连用效果上等价于 Git 世界里的提交本次工作并开始新的一次开发。一个完整的实战片段如下# 在仓库中做了一批改动后 $ jj status # 确认当前工作副本改动均为描述前的 no description 状态 $ jj describe -m Add status subcommand to show current status $ jj new # 开启下一条 change继续下一项任务 # 查看结果当前 change 已有描述 已指向全新的 change $ jj log关于jj describe与jj new的更多参数例如jj new可以指定从某个 revision 或分支派生新 change可以分别运行jj describe --help、jj new --help查阅。本文聚焦于原文档所讲的裸jj newjj describe -m这一最常用形态。简写jj commit一步完成描述 开启新变更上述两条命令是作者最早学会的 jj 模式但它有一个更省事的写法。作者从 Stevejj discord 社区处学到直接用jj commit即可。原文档对此给出了一段需要重点理解的关键引用When called without path arguments or--interactive,jj commitis equivalent tojj describefollowed byjj new.也就是说在你刚才的场景里两条命令可以压缩成一条$ jj commit -m Add status subcommand to show current status它与jj describe -m ...jj new的效果完全一致当前 change 被写入描述随后自动创建一条全新的 change 作为新的工作副本。原文作者在 jj/describe-current-changes-and-create-new-change.md 中明确表示That would have had the same result in my case在我这个场景下结果完全相同。jj commit -m ...与 Git 心智模型对照如下操作意图Gitjj固化工作区改动git addgit commit -m ...jj describe -m ...或jj commit -m ...提交后开始新工作手动创建新分支 / 等待下一次提交jj newjj commit自动完成描述当前变更写提交信息jj describe注意事项jj commit简写的适用边界原文特意强调了上述引用中提到的 caveat注意事项这也是用好jj commit的关键带路径参数时不等价当调用jj commit时若传入路径参数例如jj commit some_file.txt它只会把指定路径的改动纳入提交而非描述整个工作副本 开启新 change。此时它的语义更接近 Git 的git commit file。带--interactive时不等价使用jj commit --interactive简写-i时会进入交互式界面让你挑选要提交的文件、hunk 甚至具体行同样不是全量描述 开启新 change。保持等价的条件只有既不带路径参数、也不带--interactive时jj commit才严格等价于jj describejj new。如果你的工作副本包含大量改动而你只想挑一部分提交应当改用带路径或-i的形态而不是无参数jj commit。这也与仓库中 jj/squash-changes-into-parent-commit-interactively.md 描述的交互式jj squash -i一脉相承jj 的交互式选择界面支持空格键勾选文件、f键展开折叠查看 hunk 级 diff选好后按c确认非常适合精细控制提交哪些内容。进一步探索原文结尾建议读者查看man jj-commit获取关于该命令的更多细节——这是了解jj commit全部参数与语义边界的权威途径。此外围绕 jj 的工作流本仓库还有以下可直接继续阅读的资料jj/describe-current-changes-and-create-new-change.md本文核心describe new与commit简写的原始出处jj/squash-changes-into-parent-commit-interactively.md将工作副本变更压入父提交并支持交互式按 hunk/行挑选jj/colocate-jj-and-git-directories-for-project.mdjj git clone --colocate让.jj与.git共存git 老手可在过渡期混用两套命令jj/find-system-wide-config-file-for-user.mdjj config path --user定位用户级配置文件可按需调整ui等行为。把这套描述 新变更模式记熟配合jj commit简写你的 jj 日常开发节奏会显著更顺——每一次收尾都只需一条命令。赞分享文档教程知识库【免费下载链接】til:memo: Today I Learned项目地址https://gitcode.com/gh_mirrors/ti/til点击查看免费下载相关推荐Jujutsujj高频问题深度解析书签、提交可见性与工作副本自动快照实战指南Jujutsujj高频问题深度解析书签、提交可见性与工作副本自动快照实战指南 导读 本文基于 jj 官方 FAQ web/docs/src/conte开发工具版本控制CLIJujutsujj工作副本Working Copy完全指南自动提交、冲突物化、忽略规则与多工作区Jujutsujj工作副本Working Copy完全指南自动提交、冲突物化、忽略规则与多工作区 工作副本working copy是 Jujuts开发工具版本控制CLIJujutsujj核心设计准则解读从把工作副本当作提交到无锁并发与可插拔存储Jujutsujj核心设计准则解读从把工作副本当作提交到无锁并发与可插拔存储 Jujutsu jj 是一个与 Git 兼容、同时追求简单且强大开发工具版本控制CLI上一篇如何快速用 Microsoft Activation Scripts 一键激活 Windows 与 Office完整实操指南下一篇Forza Mods AIO极限竞速地平线4/5游戏修改的完整指南与高级调校技巧创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考