[vue-element-admin学习第一集] 报告日期：2026 年 3 月 29 日学习主题：vue-eleme

报告日期：2026 年 3 月 29 日

学习主题：vue-element-admin 项目依赖安装与 Git 远程仓库操作

一、问题与解决

本次学习围绕 vue-element-admin 项目开展，主要遇到并解决了 依赖安装失败 和 Git 远程仓库操作权限 两类问题，具体如下：

（一）依赖安装失败问题

问题现象执行 npm i 命令时出现以下报错：

plaintext

D:\documentB\learn\vue-element-admin>npm i
npm error code 128
npm error An unknown git error occurred
npm error command git --no-replace-objects ls-remote ssh://git@github.com/nhn/raphael.git
npm error git@github.com: Permission denied (publickey).
npm error fatal: Could not read from remote repository.
npm error
npm error Please make sure you have the correct access rights
npm error and the repository exists.
npm error A complete log of this run can be found in: C:\Users\86186\AppData\Local\npm-cache_logs\2026-03-29T07_26_03_085Z-debug-0.log

该报错的核心原因是：依赖包 raphael 通过 SSH 协议拉取失败，本地没有配置对应的 GitHub SSH 公钥，而非依赖版本问题。

解决方法通过对比 package.json 中的依赖版本，结合清理旧依赖并重新安装的方式解决问题，执行的核心命令及作用如下：

表格

命令片段	作用说明
`Set-Location 路径`	进入项目根目录，等同于 cmd 中的 `cd` 命令，确保后续操作在 vue-element-admin 文件夹内执行
`if (Test-Path node_modules) { Remove-Item -Recurse -Force node_modules }`	1. `Test-Path node_modules`：判断当前目录是否存在 node_modules 文件夹2. `Remove-Item -Recurse -Force`：强制递归删除文件夹，清除所有旧依赖
`if (Test-Path package-lock.json) { Remove-Item -Force package-lock.json }`	删除依赖版本锁文件，该文件记录依赖的精确版本，删除后 npm 会重新生成最新的版本信息
`npm install`（简写 `npm i`）	根据 package.json 文件重新下载并安装所有项目依赖，执行后自动生成新的 node_modules 和 package-lock.json

（二）Git 远程仓库操作权限问题

问题现象从 GitHub 拉取代码到本地后，执行 git push 推送代码时失败，原因是非原项目团队成员，无直接推送权限。
解决方法
1. 将目标项目 Fork 到自己的 GitHub 仓库，获得该项目的个人副本；
2. 基于 Fork 后的仓库克隆代码到本地；
3. 执行创建分支、切换分支等操作，在个人分支中修改代码后推送至自己的远程仓库。

（三）Git 网络连接问题

问题现象执行 git push 等远程操作时，因网络原因无法正常连接 GitHub。
解决方法配置 Git 走本地代理，解决网络连接问题，具体步骤如下：
1. 查看本地 HTTP 代理端口
  - 按 Win + I 打开设置 → 选择 网络和 Internet → 点击代理；
  - 找到 手动设置代理，查看代理地址和端口（例如 127.0.0.1:8888，其中 8888 即为代理端口，常见端口还有 7890、10809 等）。
2. 配置 Git 全局代理
  
  bash
  
  运行
```
git config --global http.proxy http://127.0.0.1:代理端口号
```

二、知识点总结

（一）npm 相关命令

npm view 命令

表格

命令参数	作用说明
`npm view`	npm 自带的查看包信息命令，用于查询 npm 包的详细内容
`tui-editor@1.3.3`	指定要查询的包名和版本号，此处为查询 `tui-editor` 包的 1.3.3 版本
`dependencies`	限定查询范围为该包的依赖项，即该包运行所需的其他包
`--json`	将输出结果格式化为 JSON 格式，便于复制、解析和查看结构
`2>nul`	Windows 系统专属参数，作用是屏蔽所有错误提示，避免错误信息干扰输出结果

（二）Git 相关操作

无团队成员权限时，需通过 Fork 项目 + 个人分支开发 的方式参与项目；
网络受限场景下，配置 Git 本地代理可有效解决远程仓库连接问题；
核心命令：
- 查看 Git 代理配置：git config --global --get http.proxy
- 取消 Git 代理配置：git config --global --unset http.proxy

三、问题纠正

本次学习中存在一个认知偏差，需纠正：

原认为依赖安装失败是版本不匹配导致，实际核心原因是 raphael 包通过 SSH 协议拉取时，本地未配置 GitHub SSH 公钥，导致权限被拒。

补充解决方法：若需通过 SSH 协议拉取依赖，需在本地生成 SSH 密钥，并将公钥添加至 GitHub 账号中，具体步骤如下：

本地生成 SSH 密钥：ssh-keygen -t rsa -C "你的 GitHub 邮箱"；

复制公钥内容（默认路径 C:\Users\你的用户名.ssh\id_rsa.pub）；

登录 GitHub → 进入 Settings → SSH and GPG keys → New SSH key，粘贴公钥并保存。

[vue-element-admin学习第一集]

一、 问题与解决