先确认git路径是否正确,再安装gitee插件并配置token;需清空凭据缓存、校准项目根目录、手动添加origin远程地址,https地址必须以https://开头。

PhpStorm 找不到 Gitee 插件入口?先确认 Git 路径是否通
根本问题往往不在 Gitee,而在 PhpStorm 根本没连上系统 Git——所有 Gitee 功能(包括插件按钮)都会灰掉或不出现。
打开 Settings > Version Control > Git,检查 Path to Git executable 是否指向真实可执行文件:
- Windows 常见路径:
C:\Program Files\Git\bin\git.exe(不是cmd\git.exe) - macOS 常见路径:
/usr/bin/git或/opt/homebrew/bin/git - 点
Test按钮,必须返回类似git version 2.40.1才算通过 - 若用 WSL 或 Portable Git,PhpStorm 不识别 UNC 路径(如
\wsl$\...),必须用 Windows 下的git.exe
Gitee 插件安装后没反应?Token 配置是关键卡点
插件装完只是第一步,Settings > Version Control > Gitee 里填错 Token 就等于没配。Gitee 不再支持密码直连,必须用 Personal Access Token(PAT)。
操作要点:
- 登录
https://gitee.com→ 头像 →设置 > 私人令牌 > 新建令牌 - 勾选
repo(读写仓库)、user_info(读取用户名),其他权限按需关闭 - 复制生成的 token 字符串,粘贴进 PhpStorm 的
Token输入框——别手误多空格或换行 - Host 保持默认
gitee.com即可,不要加https://或斜杠
右下角不显示分支、Push 失败报 “Authentication failed”?凭据缓存和仓库根目录双坑
现象是“能 clone 但 push 不了”,大概率是 PhpStorm 用了过期凭据,或压根没认出你当前项目是个 Gitee 仓库。
审计 GitHub Actions 工作流文件的密钥泄露风险,例如 pull_request_target 密钥使用、密钥回显命令及未固定版本的 Action 密钥传递。
分两步排查:
-
清凭据:Windows 进
Credential Manager > Windows Credentials,删掉所有含gitee.com或git:的条目;macOS 终端执行:git credential reject host=gitee.com" -
校仓库根:PhpStorm 不自动向上找
.git。如果项目打开的是/project/src,但.git在/project,就必须进Settings > Version Control,把Directory改成/project—— 否则右下角永远不显示分支名,Git > Repository > Remotes也为空
Commit 后 Push 按钮仍灰?检查 origin 是否已关联
新项目或手动初始化的仓库,常漏掉 git remote add origin https://gitee.com/xxx/yyy.git 这一步。PhpStorm 不会自动帮你关联系统级 remote。
验证与修复方法:
- 终端进项目根目录,运行
git remote -v。若无输出,说明没设 origin - 在 PhpStorm 终端(Alt+F12)中执行:
git remote add origin https://gitee.com/你的用户名/项目名.git - 之后刷新:
VCS > Git > Refresh File Status(Ctrl+Alt+Y),右下角分支名应立刻出现,Push 按钮变亮 - 注意:HTTPS 地址必须用
https://开头,不能用git@gitee.com:—— Gitee 插件目前不支持 SSH 密钥自动代理
最易被忽略的是:Gitee 插件只负责调用 Git 命令,它本身不替代 Git 的底层行为。任何本地 Git 配置错误(比如 user.email 未设)、远程地址拼错、或 .git/config 权限异常,都会让整个流程静默失败——别只盯着插件界面看。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!









