本教程旨在解决在windows系统中使用git时常见的“'git' 命令未识别”错误。文章将详细指导用户检查git是否已安装，并演示如何正确配置系统环境变量path，确保git可执行文件被系统识别，从而顺利初始化和管理项目版本库，例如将前端和后端项目整合到一个git仓库中。
在使用Git进行版本控制时，开发者有时会遇到系统提示“'git' 命令未识别为 cmdlet、函数、脚本文件或可运行程序的名称”的错误。这通常发生在尝试执行 git init 或任何其他Git命令时。此错误表明操作系统无法找到 git 命令对应的可执行文件，其根本原因主要有两个：Git未安装，或者Git的可执行路径未被添加到系统的环境变量PATH中。
1. 确认Git是否已安装
首先，您需要确认您的系统是否已经安装了Git。Git并非Windows操作系统的内置组件，需要单独下载并安装。
检查方法： 打开命令提示符（CMD）或PowerShell，输入以下命令并按回车：
git --version
如果Git已正确安装并配置，您将看到类似 git version 2.39.1.windows.1 的输出，这表示Git已成功安装。 如果仍然出现“命令未识别”的错误，则说明Git可能尚未安装或安装不完整。
解决方案：安装Git 如果Git尚未安装，请访问Git官方网站 (https://www.php.cn/link/0179c160e5f3a90c33f35386cab23b4a) 下载适用于您操作系统的最新版本。对于Windows用户，下载并运行安装程序，在安装过程中：
- 建议选择默认的安装路径。
- 在“Adjusting your PATH environment”步骤，请确保选择“Git from the command line and also from 3rd-party software”或类似选项，这将自动将Git添加到您的系统PATH中。如果此步骤未正确配置，您可能需要手动进行下一步的PATH配置。
- 其余选项通常可以保留默认设置。
完成安装后，请重新打开一个新的命令提示符或PowerShell窗口，再次尝试 git --version 命令进行验证。
2. 配置Git到系统环境变量PATH
即使Git已经安装，如果其可执行文件的路径没有被添加到系统的环境变量PATH中，操作系统也无法找到 git 命令。环境变量PATH是一个包含目录路径的列表，操作系统会在此列表中查找可执行文件。
解决方案：手动添加Git到PATH（Windows系统）
-
查找Git安装路径： 默认情况下，Git会安装在 C:\Program Files\Git 目录下。您需要找到Git的可执行文件所在的目录，通常是 C:\Program Files\Git\cmd。
- 如果您在安装时选择了Git Bash，可能还需要将 C:\Program Files\Git\usr\bin 添加到PATH中。
-
打开环境变量设置：
- 在Windows搜索栏中输入“环境变量”，然后选择“编辑系统环境变量”。
- 在弹出的“系统属性”窗口中，点击右下角的“环境变量”按钮。
-
编辑系统PATH变量：
- 在“环境变量”窗口的“系统变量”部分，找到名为“Path”的变量，选中它，然后点击“编辑”按钮。
- 在“编辑环境变量”窗口中，点击“新建”，然后输入Git的 cmd 目录路径，例如：C:\Program Files\Git\cmd。
- 如果需要，再新建一个，输入 C:\Program Files\Git\usr\bin。
- 点击“确定”关闭所有窗口。
重启终端： 完成环境变量配置后，务必关闭所有当前打开的命令提示符、PowerShell或Git Bash窗口，然后重新打开一个新的终端窗口。这是因为环境变量的更改只会在新的进程中生效。
3. 验证Git安装与配置
在完成上述步骤后，打开一个新的终端窗口（命令提示符或PowerShell），再次输入：
git --version
如果一切配置正确，您应该能看到Git的版本信息。这意味着您的系统现在可以识别并执行Git命令了。
总结
解决“'git' 命令未识别”错误的关键在于确保Git已正确安装，并且其可执行文件的路径已添加到系统的环境变量PATH中。一旦Git环境配置妥当，您就可以顺利地使用 git init 命令初始化您的项目仓库，无论是单独的前端或后端项目，还是将它们整合到一个统一的仓库中进行版本管理。例如，您可以在一个包含前端和后端子目录的根目录下执行 git init，然后通过 git add . 和 git commit -m "Initial commit" 将整个项目作为单个仓库进行管理。
