同一项目如何通过Git分支切换使用不同版本Cypress

切回SI分支后仍被识别为v10版本，本质是Git不会自动处理两类跨分支残留内容：

• 未被Git跟踪的文件不会随分支切换自动删除：包括v10迁移生成的cypress.config.js、v10专属的测试目录结构、Cypress本地运行缓存，这些文件残留在项目目录时，Cypress启动会优先读取高版本配置标识，直接按v10逻辑执行。
• 本地依赖包不会随分支切换自动更新：切回SI分支后如果没有重新安装依赖，node_modules里留存的还是之前安装的v10.0.3版本Cypress包，运行时自然加载v10的逻辑。

前提确认：node_modules目录必须已经加入.gitignore，没有被提交到版本库，否则永远会出现版本混乱问题。

按以下步骤配置后，仅通过Git分支检出操作就能自动切换对应版本的Cypress，不需要手动做额外操作：

1. 先清理两个分支的版本提交，确保分支内容纯净 #

• 切到SI（v9.5.4）分支，执行git clean -fdx彻底清除所有未跟踪文件、本地依赖、缓存文件，确认当前分支package.json中Cypress版本固定为9.5.4，配置文件仅保留v9对应的cypress.json，把v10生成的专属文件/目录规则补充到.gitignore，提交变更推送到远程SI分支。
• 切到SI-v10分支，同样执行git clean -fdx清除所有残留，确认当前分支package.json中Cypress版本固定为10.0.3，配置文件为v10对应的cypress.config.js，cypress目录结构符合v10要求，清除v9版本专属的残留配置后提交，推送到远程SI-v10分支。

2. 配置Git检出钩子，自动同步当前分支的依赖版本 #

Git的post-checkout钩子会在分支切换完成后自动执行脚本，用这个能力就能自动完成版本同步：

• 在项目中新建.githooks目录（方便把钩子提交到仓库给所有团队成员共用），在目录下新建post-checkout文件，写入以下脚本：

#!/bin/sh
# 清除Cypress本地缓存，避免旧版本标识干扰
rm -rf node_modules/.cache/cypress
# 按当前分支的锁文件安装完全匹配版本的依赖，用npm就保留下面这行，用yarn/pnpm换成对应的install命令即可
npm ci
echo "当前分支依赖版本已同步完成"

• 给钩子文件添加可执行权限：执行命令chmod +x .githooks/post-checkout
• 配置Git使用项目内的共享钩子目录：执行命令git config core.hooksPath .githooks，把.githooks目录提交到两个分支的版本库中，团队其他成员拉取代码后只需要执行一次上面的config命令，就能获得同样的自动切换能力。

3. 效果验证 #

• 检出SI分支，钩子会自动执行安装v9.5.4版本的Cypress，运行npx cypress run会自动读取cypress.json配置，按v9逻辑执行，不会查找v10专属目录。
• 检出SI-v10分支，钩子会自动安装v10.0.3版本的Cypress，运行时自动读取cypress.config.js配置，正常执行v10版本的测试逻辑。

补充说明：如果不想用自动安装的方式，也可以在切分支后手动执行git clean -fdx && npm ci，同样能达到版本切换的效果，只是需要手动敲命令，没法做到检出即切换。

内容的提问来源于stack exchange，提问作者KiritoLyn