vscode源代码管理Tab-文件右侧标志(M、A 等)的含义
Git 常用标志(M、A 等)的含义
- 在 VSCode 的源代码管理(Source Control)标签页中,文件右侧显示的 Monaco 装饰徽章(Badge)(如 M、A 等),本质上是对 Git 文件状态标志 的可视化呈现。这些标志对应 Git 中文件的变更类型,既在 Git 命令行工具(如 git status、git diff)中使用,也在 VSCode 的 UI 中通过 Monaco Editor 的装饰系统显示。
-
使用 man git diff-files 或 man git-status 可查看状态标志的官方说明。
-
在 Git 源码的 diff.h 中搜索 DIFF_STATUS_ADDED,可确认标志与枚举值的映射关系。
/* diff-raw status letters */#define DIFF_STATUS_ADDED 'A'#define DIFF_STATUS_COPIED 'C'#define DIFF_STATUS_DELETED 'D'#define DIFF_STATUS_MODIFIED 'M'#define DIFF_STATUS_RENAMED 'R'#define DIFF_STATUS_TYPE_CHANGED 'T'#define DIFF_STATUS_UNKNOWN 'X'#define DIFF_STATUS_UNMERGED 'U'/* these are not diff-raw status letters proper, but used by* diffcore-filter insn to specify additional restrictions.*/#define DIFF_STATUS_FILTER_AON '*'#define DIFF_STATUS_FILTER_BROKEN 'B'________________________________________________enum diff_operation {DO_DELETE = 1, /* D:删除 */DO_ADD, /* A:添加 */DO_MODIFY, /* M:修改 */DO_COPY, /* C:复制 */DO_RENAME, /* R:重命名 */DO_NOOP, /* 无操作(内部使用) */DO_UNKNOWN /* 未知操作 */};
-
VSCode 中 Monaco 装饰徽章的实现
- VSCode 的源代码管理模块通过读取 Git 状态(如 git status --porcelain 的输出),将文件状态映射为 Monaco Editor 的 装饰徽章,显示在文件列表右侧。具体逻辑如下:
- 状态标志与徽章的映射
A(新增):通常显示为 绿色徽章,表示文件未被版本控制跟踪,或新添加到暂存区。
M(修改):显示为 黄色徽章,表示文件内容已修改(未暂存或已暂存)。
D(删除):显示为 红色徽章,表示文件被删除。
R(重命名):可能显示为 蓝色徽章,并附带原文件名(如 R old.txt)。
U(未合并):显示为 橙色徽章,表示存在合并冲突,需手动处理。
A(DO_ADD): 本地新增的文件(服务器上没有)
C(DO_COPY): 文件的一个新拷贝
D(DO_DELETE): 本地删除的文件(服务器上还在)
M(DO_MODIFY): 文件的内容或者 mode 被修改了
R(DO_RENAME): 文件名被修改了
T: 文件的类型被修改了
U: 文件没有被合并(需要完成合并才能进行提交)
X: 未知状态(很可能是遇到了 git 的 bug,可以向 git 提交 bug report)
- 状态标志与徽章的映射