当你在使用 Composer 安装某个包时遇到 "Package is not a git repository" 错误，通常是因为你尝试从一个本地路径或 Git 仓库引用包，但该路径不是一个有效的 Git 仓库。这个问题常见于开发中使用 path 或 vcs 类型的自定义包。以下是几种常见原因和解决方法：

1. 检查本地包目录是否为 Git 仓库

如果你通过 repositories 配置了 "type": "path" 或 "type": "vcs" 并指向本地目录，Composer 会尝试将其当作 Git 仓库处理。

解决方法：

• 进入目标包的根目录
• 运行以下命令初始化 Git 仓库：

git init
git add .
git commit -m "Initial commit"

确保该目录下有 .git 文件夹。之后再运行 composer install 或 composer update 就不会再报错。

2. 使用 path 类型时避免强制 Git 操作

如果你只是想用本地路径加载包，不希望涉及 Git，可以设置 "relative-path" 并确保不要触发 VCS 检测。

在 composer.json 中正确配置：

"repositories": [ { "type": "path", "url": "../my-package" } ]

同时，在本地包（../my-package/composer.json）中应包含正确的名称和版本信息。Composer 会软链接该包，而不是克隆。

wechat-article-extraction-mp-weixin-qq-com news-webpage-cleaning blog-post-parsing metadata-extraction-title-author-date multiple-output-formats-markdown-json-plain-text batch-processing-support

基于三引擎设计，从微信文章、新闻和博客网页提取干净内容，支持标题作者日期元数据，多格式和批量处理。

下载

注意：如果主项目设置了 "preferred-install": "source"，它会优先尝试以源码方式安装，从而要求 Git 存在。你可以临时改为：

"config": { "preferred-install": { "my-vendor/my-package": "dist" } }

3. 清除 Composer 缓存

有时 Composer 缓存了错误的状态，即使修复了 Git 仍报错。

运行以下命令清除缓存：

composer clear-cache

然后再执行安装命令。

4. 确保路径正确且可访问

检查 repositories.url 指向的路径是否存在、拼写是否正确，并且有读取权限。

例如，若你的结构是：

/projects/main-app
/projects/my-package

那么在 main-app/composer.json 中应写：

"url": "../my-package" 基本上就这些。只要确保被引用的包目录是一个合法的 Git 仓库（或避免触发 Git 行为），问题就能解决。