本地Git关联GitHub最佳实践：Yii2扩展开发配置报错解决方案

一、解决Git分支切换报错 #

报错原因是composer安装的扩展目录内已存在全量文件，这些文件未被你初始化的本地Git仓库追踪，切换分支时会触发覆盖校验。按以下步骤处理：

• 若有自定义修改先做备份，无修改直接执行强制切换命令：git checkout -f bs4
• 重置本地分支内容和远程仓库完全一致：git reset --hard origin/bs4
• 把远程仓库地址替换为你Fork到个人账号的仓库地址，否则后续无法推送代码：git remote set-url origin 你自己的Fork仓库地址

二、配置本地修改即时生效的开发环境 #

直接修改vendor目录内的扩展文件存在被composer更新覆盖的风险，推荐使用Composer的path源配置实现修改即时生效，同时解决目录名不一致问题：

• 在你的Yii2项目根目录新建extensions文件夹，把当前扩展目录整体移动到该文件夹下，可自定义目录名解决名称不一致问题
• 打开项目根目录的composer.json文件，添加/修改repositories配置项：

{
  "repositories": [
    {
      "type": "path",
      "url": "./extensions/你的扩展目录名",
      "options": {
        "symlink": true
      }
    }
  ]
}

• 执行命令重新关联扩展：composer require dadinugroho/user-management:dev-bs4

执行完后Composer会自动创建符号链接指向你放在extensions目录下的扩展，不会再从远程拉取扩展代码

三、验证配置 #

• 直接修改extensions目录下的扩展代码，刷新项目对应功能页面，确认修改无需执行composer update即可生效
• 在扩展目录内执行Git命令，确认可以正常提交、推送代码到你个人的Fork仓库

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