0

0

composer 提示 "git was not found, check that it is installed and in your PATH" 终极解决方案

裘德小鎮的故事

裘德小鎮的故事

发布时间:2025-11-22 15:35:02

|

258人浏览过

|

来源于php中文网

原创

先确认Git是否安装并配置到PATH中。若未安装,需下载Git并选择添加至PATH;已安装则检查环境变量是否包含Git路径,如C:\Program Files\Git\bin或/usr/bin/git;WSL用户应在子系统内安装Git;最后重启终端或IDE确保Composer可调用Git命令。

composer 提示 \

当你在使用 Composer 安装或更新 PHP 包时,遇到提示 "git was not found, check that it is installed and in your PATH",说明系统无法找到 Git 命令。这个问题虽然常见,但只要一步步排查,就能彻底解决。以下是终极解决方案。

确认 Git 是否已安装

Composer 在拉取某些包(尤其是开发分支或私有仓库)时会调用 Git。如果 Git 没装或无法被识别,就会报错。

打开终端(Windows 是 CMD 或 PowerShell,macOS/Linux 是 Terminal),运行:

git --version

如果返回类似 git version 2.xx.x,说明 Git 已安装。如果提示“不是内部或外部命令”,则需要安装 Git。

安装 Git(如未安装)

  • Windows:前往 https://www.php.cn/link/7ca2d2c04c0bb98f7b3481751387214a 下载并安装 Git。安装过程中建议选择“Add Git to PATH”选项(推荐使用默认安装设置)。
  • macOS:可通过 Homebrew 安装:
    brew install git
  • Linux(Ubuntu/Debian)
    sudo apt update && sudo apt install git

检查 Git 是否在系统 PATH 中

即使安装了 Git,如果它不在环境变量 PATH 中,Composer 依然找不到。

运行以下命令查看 PATH:

echo %PATH%(Windows CMD)
echo $PATH(macOS/Linux 或 Windows WSL)

查找是否包含 Git 的安装路径,例如:

  • Windows 常见路径:C:\Program Files\Git\binC:\Program Files\Git\cmd
  • macOS/Linux:通常为 /usr/bin/git 或通过 Homebrew 安装在 /opt/homebrew/bin

如果路径缺失,需手动添加。

Flowise
Flowise

一款开源的低代码/无代码AI应用开发工具

下载

手动添加 Git 到 PATH(Windows 示例)

  1. 右键“此电脑” → “属性” → “高级系统设置” → “环境变量”
  2. 在“系统变量”中找到 Path,双击编辑
  3. 添加以下两条路径(根据你的实际安装位置调整):
    C:\Program Files\Git\bin
    C:\Program Files\Git\cmd
  4. 保存后,重启终端或重新登录系统

再次运行 git --version 测试是否生效。

验证 Composer 是否能调用 Git

关闭所有终端窗口,重新打开,执行:

composer installcomposer require xxx

如果不再出现 git 找不到的错误,说明问题已解决。

特殊情况处理

如果你使用的是 WSL(Windows Subsystem for Linux):

  • 确保在 WSL 内部安装 Git:sudo apt install git
  • Composer 应该也在 WSL 环境中运行,不要混用 Windows 和 WSL 的路径

如果你使用 PhpStorm 或其他 IDE 内置终端报错,但外部终端正常,请重启 IDE —— 它可能没有读取最新的环境变量。

基本上就这些。只要 Git 装了、PATH 配对了、终端重启了,Composer 就不会再报这个错。不复杂,但容易忽略细节。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
composer是什么插件
composer是什么插件

Composer是一个PHP的依赖管理工具,它可以帮助开发者在PHP项目中管理和安装依赖的库文件。Composer通过一个中央化的存储库来管理所有的依赖库文件,这个存储库包含了各种可用的依赖库的信息和版本信息。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

151

2023.12.25

phpstorm怎么导出项目
phpstorm怎么导出项目

phpstorm提供导出项目功能,步骤如下:打开phpstorm项目转到“项目”菜单选择“导出项目”选择导出格式指定导出位置选择导出范围勾选“包括依赖项”框(可选)单击“导出”完成导出。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

363

2024.04.08

phpStorm怎么运行
phpStorm怎么运行

本专题整合了phpstorm运行教程,阅读专题下面的文章了解更多相关内容。

84

2025.09.18

phpstorm开发环境搭建教程
phpstorm开发环境搭建教程

本专题整合了phpstorm开发环境搭建和运行项目教程,阅读专题下面的文章了解更多详细教程。

76

2025.09.18

phpstorm怎样运行php
phpstorm怎样运行php

本专题整合了phpstorm运行php相关教程,阅读专题下面的文章了解更多详细内容。

62

2025.09.18

phpstorm相关教程大全
phpstorm相关教程大全

本专题整合了phpstorm相关教程汇总,阅读专题下面的文章了解更多详细内容。

12

2026.01.15

require的用法
require的用法

require的用法有引入模块、导入类或方法、执行特定任务。想了解更多require的相关内容,可以阅读本专题下面的文章。

466

2023.11.27

自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

724

2023.07.05

俄罗斯Yandex引擎入口
俄罗斯Yandex引擎入口

2026年俄罗斯Yandex搜索引擎最新入口汇总,涵盖免登录、多语言支持、无广告视频播放及本地化服务等核心功能。阅读专题下面的文章了解更多详细内容。

31

2026.01.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 9.9万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.2万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号