在使用VS Code管理项目代码时,不少用户会遇到点击初始化仓库按钮后提示失败的情况,这通常是Git核心工具未安装或配置不当导致的。下面先通过一张示意图了解整体解决流程:

一、确认Git是否已安装
首先打开系统终端,输入以下命令检查Git是否已经被正确安装:
# 查看Git版本,若返回版本号则说明已安装 git --version
如果终端提示命令不存在,说明本地还没有安装Git核心工具,需要先进行安装操作。
二、安装Git核心工具
Windows系统安装步骤
访问Git官方下载页面获取安装包,按照以下流程完成安装:
- 双击安装包,点击下一步进入安装向导
- 选择安装路径,建议保持默认路径避免后续路径识别问题
- 在组件选择页面,勾选
Git_Bash_Here和Git_GUI_Here选项,方便后续操作 - 调整PATH环境选项时,选择
Git_from_the_command_line_and_also_from_3rd-party_software,确保系统可以全局识别Git命令 - 其余选项保持默认,点击完成结束安装
macOS系统安装步骤
打开终端输入以下命令通过Homebrew安装Git:
# 安装Homebrew(如果未安装) /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # 安装Git brew install git
Linux系统安装步骤
根据系统包管理器选择对应命令安装:
# Debian/Ubuntu系统 sudo apt-get update sudo apt-get install git # CentOS/RHEL系统 sudo yum install git
三、配置VS Code识别Git路径
安装完成后,打开VS Code,按下Ctrl+Shift+P打开命令面板,输入Git:Select_Git_Path,选择Git可执行文件的路径:
- Windows默认路径为
C:\Program Files\Git\bin\git.exe - macOS默认路径为
/usr/bin/git - Linux默认路径为
/usr/bin/git
选择完成后重启VS Code,再次尝试初始化仓库即可成功。
四、验证初始化是否成功
在VS Code中打开项目文件夹,点击左侧源代码管理图标,点击初始化仓库按钮,若左侧出现提交记录面板,说明初始化成功。也可以通过终端验证:
# 进入项目目录 cd 你的项目路径 # 查看Git仓库状态 git status
如果返回当前分支为main或master,且没有报错信息,说明Git仓库已经正常初始化,后续就可以正常进行代码提交、分支管理等操作了。