webstorm关联gitee并拉取代码的前提是本地已初始化git仓库;若无.git目录,须先执行git init或右键→git→create git repository,再通过get from vcs克隆远程仓库,确保https凭据保存或ssh密钥配置正确。

WebStorm 关联 Gitee 仓库并拉取代码,核心前提是「本地还没 Git 仓库」——如果你直接打开一个空文件夹就想 push 或 pull,IDE 会静默失败,连错误提示都懒得给。
没初始化本地仓库?git init 是必走一步
WebStorm 不会在你打开任意文件夹时自动帮你初始化 Git。它只认 .git 目录是否存在。没有这个目录,所有远程操作(包括 Pull)都会卡在“无仓库”状态。
- 确认项目根目录下有
.git文件夹(隐藏),没有就手动执行git init - 或在 WebStorm 中右键项目根目录 →
Git→Create Git Repository - 如果已存在
.git但 IDE 没识别,进Settings > Version Control > Git检查Path to Git executable是否指向有效路径(如C:\Program Files\Git\bin\git.exe或/usr/bin/git) - 终端运行
git remote应返回空(说明尚未关联远程),若报错not a git repository,说明本地根本没仓库
用 Get from VCS 直接克隆,跳过手动关联
这是最稳、最省事的方式,尤其适合刚从 Gitee 页面复制了仓库 URL 的场景。它把 git clone、git remote add、甚至项目导入全包了。
- 启动 WebStorm,点欢迎页的
Get from VCS(不是New Project) - Version Control 选
Git,URL 填 Gitee 项目页右上角“克隆/下载”里的 HTTPS 地址(如https://gitee.com/username/repo.git),务必删掉前后空格和换行 - Directory 选本地目标路径,点
Clone,WebStorm 会自动执行git clone并完成仓库绑定 - 克隆完成后,项目自动处于 Git 管理下,
Update Project (Ctrl+T)就能拉取最新代码
Push rejected 或弹窗反复要密码?HTTPS 凭据没存住
即使 URL 正确、仓库存在,HTTPS 方式拉取或推送失败,90% 是凭据问题。WebStorm 默认不保存密码,输错一次或取消后,后续操作直接挂。
- 首次输入 Gitee 账号密码时,必须勾选弹窗底部的
Remember password(极易被忽略) - 如果已勾选仍失败,去系统凭据管理器清理旧记录:Windows 用“凭据管理器”搜
gitee.com,macOS 用“钥匙串访问”搜同名条目,Linux 查GNOME Keyring - SSH 方式则完全绕过密码问题,但需提前生成密钥:
ssh-keygen -t ed25519 -C "your-email@example.com",再把~/.ssh/id_ed25519.pub全文粘贴到 Gitee 账户的 SSH 公钥设置里 - 企业内网 Gitee 实例需额外配置:
Settings > Version Control > Gitee,把Server URL改成实际地址(如https://gitee.internal.company)
Gitee 插件没装?View Pull Requests 找不到
WebStorm 自带 GitHub 的 PR 工具窗口,但 Gitee 需要插件支持。没装插件,点 Git → GitHub → View Pull Requests 对 Gitee 项目完全无效,也不会报错,只是没反应。
- 先装插件:Settings → Plugins → 搜索
Gitee Pull Requests→ Install → Restart IDE - 重启后,用
View → Tool Windows → Gitee Pull Requests打开(不是 GitHub 菜单下的那个) - 首次打开会引导登录 Gitee 账户;若没反应,检查
VCS → Git → Remotes是否有形如origin指向gitee.com/xxx/yyy.git的条目 - 当前分支必须已
push过至少一次,PR 列表才可能加载出来
最容易被忽略的是:克隆完不等于“可协作”。得确保远程 URL 协议与认证方式对齐(HTTPS 配凭据、SSH 配密钥),且分支已 track。否则 Update Project 看似点了,实际什么都没拉下来。











