gitmoji插件不弹窗的根本原因是vscode原生提交绕过插件，必须用ctrl+shift+p→“gitmoji: commit”触发；它仅提供emoji前缀选择，不自动格式化、不干预终端命令、不处理渲染问题。
Gitmoji 插件装了但 git commit 里没弹出表情选择框
根本原因是 VSCode 的 Git 提交面板默认不调用插件的提交钩子，它走的是原生 Git CLI 流程，而 Gitmoji 插件（比如 gitmoji-vscode）只在「通过插件触发提交」时才激活表情面板。
实操建议：
- 别点右下角「Commit」按钮，也别用
Ctrl+Enter直接提交 —— 这俩都绕过插件 - 必须用插件提供的入口：按
Ctrl+Shift+P→ 输入Gitmoji: Commit→ 回车，才会弹出带 emoji 的交互式表单 - 确认插件已启用：在 VSCode 扩展页搜
gitmoji-vscode，检查状态是「Enabled」而非「Disabled」 - 如果用了
husky或commitlint，确保它们没拦截或重写git commit命令，否则插件无法注入 UI
选完 Gitmoji 后提交信息格式不对，比如缺空行或描述太短
Gitmoji 本身只负责前缀，后续格式（空行、正文、footer）得靠你手动补全，插件不会自动加换行或校验长度 —— 它不是 linter，只是 picker。
常见错误现象：
- 提交信息变成
? feat: deploy一整行，没换行，导致git log --oneline看起来像没格式 - CI 报错
subject may not be empty或body must be at least 10 chars，其实是 commitlint 规则在生效，不是插件问题
实操建议：
- 在插件弹出的输入框里，选完 emoji 后，**手动敲回车**，再写描述（至少 1 行空行 + 至少 1 句话）
- 推荐模板：
? feat: add user login→ 换行 → 空行 →Implements JWT auth flow with refresh token. - 如果想自动化格式，得配
.commitlintrc.json+huskypre-commit 钩子，插件本身不提供这个能力
VSCode 终端里执行 git commit 不触发 Gitmoji 面板
这是设计使然。Gitmoji 插件只作用于 VSCode 内置的 Git UI（即命令面板里的 Gitmoji: Commit），对终端里的原生命令零干预 —— 它没法劫持 shell 的 git 调用。
使用场景：
- 日常快速提交用插件面板；需要脚本化、CI/CD、或和别人协作复现 commit 流程时，还是得靠终端 +
git commit -m手动加 emoji - 别指望插件让
git commit -m "? feat: ..."自动补全或校验 —— 它不监听终端输入
参数差异：
-
Gitmoji: Commit→ 图形化、带搜索、强制 emoji 前缀、不兼容非交互式环境 -
git commit -m→ 纯文本、无校验、可脚本化、需自己查gitmoji.dev找对应 emoji
提交后发现 emoji 显示成方块或乱码
不是插件问题，是终端/日志查看器不支持 Unicode emoji 渲染，尤其 Windows CMD、旧版 Git Bash、某些 SSH 终端默认禁用 UTF-8 或缺少字体。
性能 / 兼容性影响：
- emoji 本身只是 UTF-8 字符，不影响 Git 存储、diff、rebase 等任何底层操作
- 但
git log --oneline在窄终端里可能折行错位，git show中 emoji 显示异常不代表提交损坏
实操建议：
- Windows 用户优先切到
Windows Terminal+ 设置字体为Consolas或Cascadia Code - Linux/macOS 检查终端编码：
locale | grep UTF-8，若无输出，加export LANG=en_US.UTF-8到 shell 配置 - CI 日志里看到方块？不用管，只要
git log --pretty='%s'输出含 emoji 字符，就说明提交正确
