通过PhpStorm提交Git时实现npm自动版本控制的问题

核心问题分析 #

你遇到的矛盾点在于：

• npm version 默认要求工作目录干净才能创建tag，但pre-commit钩子触发时，Git已经暂存了你要提交的代码，导致工作目录"不干净"
• 用--no-git-tag-version虽然能更新版本，但修改的package.json/package-lock.json不在PhpStorm预选的提交列表里，无法同步提交，进而引发循环

解决方案一：修改pre-commit钩子，自动暂存版本文件并打tag #

直接调整.git/hooks/pre-commit脚本，让它处理暂存区并完成版本更新、打tag的全流程：

1. 替换或创建pre-commit脚本（确保有执行权限：chmod +x .git/hooks/pre-commit）：

#!/bin/sh
# 1. 更新补丁版本，不自动提交/打tag
npm version patch --no-git-tag-version

# 2. 将更新后的版本文件加入本次提交的暂存区
git add package.json package-lock.json

# 3. 手动创建对应版本的Git tag
VERSION=$(node -p "require('./package.json').version")
git tag "v$VERSION"

2. 提交代码时的操作：
   • 在PhpStorm中正常选择你要提交的业务代码文件
   • 点击提交，钩子会自动更新版本号、把版本文件加入暂存区、创建tag，最终所有变更（业务代码+版本文件）会一起提交

这样就能避免版本文件遗漏，也不会出现循环提交的问题，本地提交后版本号和代码同步，服务器拉取后版本和本地完全一致。

解决方案二：通过stash暂存临时文件，让npm version自动处理 #

如果你更倾向于用npm version的默认行为（自动暂存版本文件+打tag），可以用stash先暂存已选的提交文件，待版本更新完成后再恢复：

#!/bin/sh
# 1. 暂存当前所有变更（包括已暂存的业务代码）
git stash push -m "pre-commit-temp-stash" --include-untracked

# 2. 此时工作目录干净，执行npm version自动更新版本、打tag、暂存版本文件
npm version patch

# 3. 恢复之前暂存的业务代码
git stash pop

# 4. 将业务代码和版本文件一起加入暂存区
git add .

这个方案的好处是完全利用npm version的原生逻辑，不需要手动打tag，但需要注意：如果你的工作目录有未追踪的临时文件，可能会被stash一起暂存，不过--include-untracked可以确保所有变更都被临时保存。

额外注意事项 #

• 确保PhpStorm启用了Git钩子：在Settings > Version Control > Git中，确认"Enable Git hooks"选项已勾选
• 流水线中不要再执行npm version：现在本地提交已经同步了版本文件，流水线直接拉取代码构建即可，避免版本不一致
• 如果需要升级大版本（minor/major），只需把脚本中的patch改成minor或major即可

内容的提问来源于stack exchange，提问作者Kristjan O.