gitmoji插件仅生成带表情的提交前缀，不参与实际提交；需手动触发（快捷键或右键），默认插入图形emoji而非别名，不补全冒号、空格及type前缀，依赖git仓库就绪且不支持dev container未挂载.git场景。
Gitmoji 插件本身不参与 Git 提交，它只帮你生成带表情的提交前缀；真正的提交行为仍由 VSCode 内置 Git 功能或命令行完成，插件不接管 git commit 流程。
怎么安装并启用 Gitmoji 插件
在 VSCode 扩展市场搜索 gitmoji，认准作者是 carloscuesta 的官方插件（名称为 Gitmoji），点击安装后无需重启。插件默认启用，但不会自动弹出——它只在你主动触发时才出现。
常见误区：Gitmoji 不会监听你输入 git commit -m 或编辑提交框时自动激活。必须手动唤起：
- 快捷键：
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Gitmoji: Insert Emoji并回车 - 右键编辑器中任意文本位置，选择
Insert Gitmoji - 在源代码管理视图（Ctrl+Shift+G）的提交输入框中，光标聚焦后按
Ctrl+Shift+P同样有效
为什么输入框里选了 emoji 却没自动加冒号和空格
VSCode 的 Git 提交输入框是纯文本区域，Gitmoji 插件默认只插入 emoji 字符本身（如 ?），不补全 :rocket: 或后续空格。这是设计使然，不是 bug。
如果你习惯用 emoji 别名（如 :tada:）而非图形符号，需要手动切换模式：
- 打开命令面板（
Ctrl+Shift+P），运行Preferences: Open Settings (JSON) - 添加配置：
"gitmoji.useEmoji": false - 重启命令面板再执行
Gitmoji: Insert Emoji，此时会插入别名格式（如:tada:），但注意：部分 Git 钩子或 CI 工具可能不识别别名，只渲染 emoji 图形
另外，插件不负责补全分类描述（如 feat:、fix:）。这些前缀需你手动输入，或配合其他插件（如 Conventional Commits）协同使用。
提交信息格式冲突：emoji 放前面还是后面？
Gitmoji 官方推荐格式是 emoji 空格 type: description，例如：✨ feat: add dark mode toggle。但 VSCode 提交框不校验格式，也不阻止你写成 feat: add dark mode toggle ✨。
关键影响点：
- CI/CD 工具（如 Semantic Release）通常依赖正则匹配开头的 emoji + type，错位会导致解析失败
- GitHub/GitLab 的提交列表页对开头 emoji 渲染更稳定；末尾 emoji 可能被截断或忽略
- VSCode 内置 Git 不限制长度，但终端显示宽度有限，过长 emoji 组合（如
???）会让第一行拥挤，建议单次只选 1 个核心 emoji
为什么按了快捷键没反应，或者列表为空
最常见原因是当前工作区未初始化 Git 仓库，或 VSCode 没识别到 .git 目录。插件启动依赖 Git 环境就绪：
- 确认项目根目录存在
.git文件夹（可用终端执行git status验证） - 检查 VSCode 底部状态栏是否显示分支名（如
main）；若显示No source control providers，说明 Git 扩展未启用或路径异常 - 插件不支持远程开发容器（Dev Container）内 Git 未挂载
.git的场景，需确保容器内已执行git init或克隆完成 - 极少数情况是快捷键被其他插件占用，可进
File > Preferences > Keyboard Shortcuts搜索gitmoji查看绑定状态
插件本身不缓存 emoji 数据，每次唤起都实时读取内置 JSON 列表，所以网络不通不影响使用——但如果你手动修改过 ~/.vscode/extensions/carloscuesta.gitmoji-*.*/data/gitmojis.json，可能导致列表异常，建议删掉扩展重装。
