path模式不生效的三大主因：本地包composer.json中name字段与require包名不一致；未清缓存导致复用旧dist包；项目已通过Packagist安装同名包却未先remove。
为什么 path 模式不生效？常见原因就这三条
Composer 的 path 模式挂载本地包，最常失败不是因为写法错，而是因为路径、缓存、或依赖约束没对上。它不像 git 源那样自动拉取更新，一旦缓存命中，改了本地代码也不会反映到项目里。
-
path对应的目录必须包含有效的composer.json，且其中的name字段（如"myorg/chinese-utils"）要和你require的包名完全一致，包括大小写和斜杠方向 - 执行
composer install或composer update前，先运行composer clear-cache—— 否则 Composer 可能复用旧的 dist 包，根本不会走path - 如果项目已通过 Packagist 安装过同名包，必须先
composer remove myorg/chinese-utils，再在composer.json中补上repositories配置，否则 Composer 会优先走远程源
repositories 怎么写才不踩坑
很多人把 repositories 放在项目根目录的 composer.json 里，但位置和结构稍有偏差就会静默失效。它必须是顶层字段，不能嵌套在 config 或 extra 里。
{
"repositories": [
{
"type": "path",
"url": "../chinese-utils"
}
],
"require": {
"myorg/chinese-utils": "*"
}
}
注意：url 是相对于当前项目 composer.json 的路径，不是相对于命令行当前目录；支持 ../、./vendor-local/ 这类相对路径，但不支持 ~ 或环境变量；Windows 下反斜杠 \ 会被解析失败，一律用正斜杠 /。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
本地包修改后如何让项目立刻生效
path 模式不是实时 symlink（除非你手动 ln -s），而是 Composer 在安装时把整个本地目录复制进 vendor/。所以改完中文包代码，必须重新触发安装逻辑，否则 vendor 里的副本还是旧的。
- 最稳妥：删掉
vendor/myorg/chinese-utils目录，再执行composer install - 快捷但有风险：用
composer update myorg/chinese-utils --with-dependencies，它会重新解析path并覆盖 vendor 内容 - 开发调试阶段建议在本地包的
composer.json中加"minimum-stability": "dev"和"prefer-stable": false，避免因稳定性约束导致 fallback 到 Packagist 版本
中文包名含非 ASCII 字符？别这么干
Composer 规范明确要求 name 字段只能是小写字母、数字、连字符和斜杠，不允许中文、全角字符、下划线或空格。哪怕你本地文件系统能保存，Packagist 不接受，Composer 解析器也会报错 Invalid package name。
正确做法是用语义化英文名，比如 "zh-cn/validator" 或 "laravel-china/helpers"，然后在 description 或 keywords 里写中文说明。强行用中文命名会导致 composer require 失败、IDE 无法识别、CI 构建中断——这些都不是路径问题，是规范越界。
