Composer明确不支持手动修改vendor/代码，因其是只读缓存区，改动必被覆盖；正确做法是用path仓库映射本地包目录，通过符号链接实现热更新且避免Git误提交。
本地包必须用 path 仓库，不能手动改 vendor
Composer 明确不支持修改 vendor/ 目录里的代码——它只是只读缓存区。你改了 src/Helper.php，下次 composer update 或 composer install 就会被覆盖。更危险的是，有人会把改过的 vendor/ 提交进 Git，导致 CI 构建失败、本地行为和线上不一致。
正确做法是用 path 类型仓库映射本地目录，让 Composer 把你的开发副本当“真实包”对待。这样改代码直接生效，且 vendor/ 下实际是个符号链接（Linux/macOS）或目录映射（Windows），根本不会产生可提交的变更文件。
-
repositories必须写在主项目composer.json根级，不能塞进extra或子目录里 -
url用相对路径（如"../my-utils"），别用file://或绝对路径 - 本地包目录下必须有合法
composer.json，且name字段与require中完全一致（大小写敏感） - 确认
vendor/my-vendor/my-package是符号链接：ls -l vendor/my-vendor/my-package应显示-> ../my-utils
为什么 git status 看不到 vendor 变更，但还是误提交了
因为有人把整个 vendor/ 目录加进了 Git（比如删了 .gitignore 里对 /vendor 的规则），或者用 IDE 全局提交时没过滤掉。一旦 vendor/ 被纳入版本控制，CI 拉代码后运行 composer install 就会冲突，甚至因权限/符号链接问题直接失败。
真正安全的做法是：确保 .gitignore 里有明确一行 /vendor（开头带 / 防止匹配子目录），且从不手动 git add vendor/。
- 检查是否已误提交：
git ls-files | grep "^vendor/"，若有输出说明已被跟踪 - 清除已跟踪的 vendor：
git rm -r --cached vendor，再git commit -m "remove vendor from git" - 验证是否生效：
git status不再列出vendor/下任何文件 - 如果本地包本身是 Git 仓库，它的
.git目录不会被主项目 Git 递归跟踪——这是安全的
如何让本地包改动不进 Git，又不影响调试
核心是靠 path 仓库 + 符号链接机制。只要 vendor/ 是软链，你改的代码都在外部目录（如 ../my-utils），而那个目录是你自己管理的 Git 仓库——你可以自由 commit、branch、push，和主项目无关。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
常见错误是把本地包目录放在主项目 vendor/ 下面（比如 vendor/my-utils），这会让 IDE 或 git add . 误认为它是项目一部分。正确位置应在项目同级（../my-utils）或独立路径（~/dev/my-utils）。
- 本地包目录必须已执行
git init并至少有一个 commit，否则 Composer 会静默 fallback 到复制模式，失去热更新能力 - 不要在本地包里放
vendor/，除非它本身是可独立运行的应用；库项目应只含src/、tests/、composer.json - 若用全局
repositories（composer config -g repositories.xxx），注意 URL 中通配符*匹配的目录也必须各自是独立 Git 仓库 - 临时关闭某个本地包？直接删掉其目录，
composer install会跳过它（不报错），比注释配置更干净
CI/生产环境怎么避免 path 仓库生效
path 仓库只应在开发阶段启用。CI 和生产环境不该依赖本地路径——它们没那些目录，也没必要。
Composer 默认行为是：当 path 源不可用时，自动 fallback 到 Packagist 或其他已配置源（前提是 require 版本约束允许）。但前提是你的 composer.lock 里没锁定为 "source": {"type": "path"}。
- 开发时用
dev-main或@dev，上线前必须切回稳定版本（如"1.2.3"）并composer update vendor/package --with-dependencies - CI 脚本里加
COMPOSER_DISABLE_NETWORK=0（默认）+--no-plugins防插件联网，但不要设repo.packagist false，否则 fallback 失败 - 检查
composer.lock：搜索"source":.*"path"，上线前必须清空这类字段 - 最保险做法：CI 使用
composer install --no-dev，并确保require中不含任何dev-前缀版本
最容易被忽略的一点：符号链接是否真生效。Windows 上没开“开发者模式”或没管理员权限，Linux/macOS 上目标目录权限不足，都会让 Composer 静默退回到 copy 模式——这时你改代码，项目里根本看不到变化，还误以为是 autoload 问题。先 ls -l vendor/xxx 确认箭头，再查问题。
