将Vue 项目上传到Gitee流程步骤

1. 安装 Node.js

  1. 打开官网:http://nodejs.org/en/download/

  2. 推荐下载 LTS 长期维护版(稳定),也可以选择 CURRENT 最新版

  3. 安装完成后,打开命令行(cmd),输入: bash

    运行

    复制代码
    node -v   # 显示版本号,如 v7.10.1 表示安装成功
    npm -v    # 显示 npm 版本号,npm 是 Node 包管理工具

2. 准备代码仓库(码云 Gitee)

  1. 打开码云:http://gitee.com
  2. 注册账号并登录
  3. 创建一个私有仓库 ,命名为 travel,用于存储项目代码

3. 安装 Git

  1. 打开 Git 官网:https://git-scm.com/

  2. 下载并安装 Git

  3. 验证安装:在命令行输入 bash

    运行

    复制代码
    git --version   # 显示版本号即成功
  4. 设置 SSH 公钥

    • 在 Git Bash 中执行: bash

      运行

      复制代码
      ssh-keygen -t rsa -C "你的邮箱"
    • 一路回车,生成公钥文件

    • 找到 ~/.ssh/id_rsa.pub 文件,复制内容

    • 在码云的「设置」→「SSH 公钥」中粘贴并保存


4. 部署原始Vue项目:

npx create-vue 创建 Vue 3 项目的交互式配置界面-CSDN博客

5. Git 版本控制


🧠 一句话总结

,是 Git 告诉你:"这里没有 Git 仓库,没法操作。"

只要执行 git init 就能解决~

2. 被忽略的文件 ❌

这些文件 / 文件夹被 .gitignore 规则排除,不会被提交


🧐 为什么要忽略这些文件?

  1. travel 目录下打开 Git Bash

  2. 查看本地仓库状态: bash

    运行

    复制代码
    git status

❌ 报错含义

当前所在的文件夹 不是一个 Git 仓库(里面没有 .git 文件夹),所以无法执行 git status 等命令。


📌 出现原因

你现在的目录下:
5. 没有初始化 Git(git init
6. 不是克隆下来的项目(没有 .git 目录)所以 Git 命令无法识别
7. 添加所有文件到暂存区: bash

运行

复制代码
   git add .
  1. 提交代码: bash

    运行

    复制代码
    git commit -m 'project initialized'
  2. 提交成功了!

    从输出可以看到:

  3. 你在 master 分支完成了第一次提交,提交信息是:董文柯第一次提交

  4. 一共创建了 30 个文件,新增了 5090 行代码

  5. 所有项目文件(配置文件、Vue 组件、路由、样式等)都已经被成功记录到本地 Git 仓库里

  6. 从你的 .gitignore 文件和提交日志来看,并不是所有文件都被提交了,核心原因如下:

    1. 已被提交的文件 ✅

    这些是项目的核心代码和配置文件,已经被成功提交到 Git 仓库:

  7. src/:你的 Vue 组件、页面、路由等业务代码

  8. public/:静态资源(如 favicon.ico)

  9. 配置文件:.editorconfig.gitattributes.eslintrc.jsonpackage.json

  10. README.md:项目说明文档

  11. vite.config.js:Vite 构建工具配置

  12. node_modules/:依赖包文件夹(体积巨大,由 package.json 记录,无需提交)

  13. .vscode/:VS Code 编辑器的本地配置(仅对你的电脑生效)

  14. package-lock.json:虽然你截图里有,但如果在 .gitignore 中被排除,也不会提交(不过通常建议提交这个文件以锁定依赖版本)

  15. node_modules/ :体积非常大,且可以通过 npm install 重新生成,提交会浪费仓库空间和带宽。

  16. 编辑器配置.vscode/ 这类文件是你的个人开发环境配置,不适合共享给其他开发者。

  17. 临时文件 :日志、缓存等文件也会被 .gitignore 忽略,避免仓库混乱。

  18. 关联远程仓库并推送: bash

    运行

    复制代码
    git remote add origin 你的码云仓库SSH地址
    git push -u origin master

🎉 太棒了!推送成功了!

这是 Git 推送完成的日志,我帮你逐句解读:


1. 核心成功信息

  • Enumerating objects: 40, done.:统计到要推送的对象共 40 个
  • Counting objects: 100% (40/40), done.:计数完成
  • Compressing objects: 100% (36/36), done.:压缩对象完成
  • Writing objects: 100% (40/40), 45.12 KiB | 1.29 MiB/s, done.:写入对象到远程仓库完成,速度 1.29 MiB/s
  • Total 40 (delta 0), reused 0 (delta 0), pack-reused 0:总共 40 个对象,无增量修改

2. 关键成功标志

  • remote: Powered by GITEE.COM:这是 Gitee 服务器的响应,说明连接成功
  • * [new branch] master -> master成功创建了远程 master 分支 ,并将本地 master 分支的代码推送到了远程
  • branch 'master' set up to track 'origin/master':本地 master 分支已和远程 origin/master 分支建立了追踪关系 ,以后推送只需执行 git push 即可


拓展:用于安装npm包: (可选)安装淘宝镜像加速

bash

运行

复制代码
npm install -g cnpm --registry=https://registry.npm.taobao.org

之后可以用 cnpm 替代 npm 命令,下载速度更快。

这个命令的作用 🚀

这条命令是用来安装淘宝镜像版的 cnpm 工具 ,核心目的是加速 npm 包的下载速度,解决国内访问 npm 官方源慢、容易超时的问题。


详细拆解

  • npm install -g cnpm:全局安装 cnpm 工具(cnpm 是 npm 的淘宝镜像客户端)
  • --registry=https://registry.npm.taobao.org:指定从淘宝镜像源下载包,而不是从国外的 npm 官方源

实际效果

  • 安装后,你可以用 cnpm 命令完全替代 npm,比如:

    bash

    运行

    复制代码
    cnpm install  # 替代 npm install
    cnpm run serve  # 替代 npm run serve
  • 下载速度会快很多,尤其是在安装大型依赖(如 Vue CLI、webpack 等)时,能明显减少等待时间,避免下载失败。


注意事项 ⚠️

  1. 可选操作 :不是必须安装,你之前已经通过 npm config set registry 切换了淘宝源,也能达到加速效果,cnpm 只是更方便的客户端封装。

  2. 兼容性问题 :极少数情况下,cnpm 可能和某些包的依赖解析有细微差异,如果遇到问题,换回 npm 即可。

  3. 源地址更新 :现在淘宝镜像的新地址是 https://registry.npmmirror.com,老地址 registry.npm.taobao.org 也还能用,但推荐用新地址:

    bash

    运行

    复制代码
    npm install -g cnpm --registry=https://registry.npmmirror.com

总结

  • 如果你平时下载 npm 包很慢、经常超时,建议安装 ,用 cnpm 替代 npm 会更顺畅。
  • 如果你已经切换了 registry,且下载速度没问题,也可以不安装 ,直接用 npm 就行。


问题核心分析

该报错的本质是远程仓库(码云)与本地仓库的提交历史不一致 :你在码云创建仓库时,可能勾选了「初始化仓库」(自动生成READMELICENSE等文件),导致远程仓库已有提交记录,而本地是全新初始化的项目,Git 拒绝直接覆盖,要求先整合差异。

解决方案(按优先级排序,推荐方案 1)

方案 1:拉取并合并远程代码(最安全,保留远程文件)

该方法会将远程仓库的文件(如README)拉到本地,与你的 Vue 项目合并,适合需要保留远程初始化文件的场景。

  1. 执行拉取与合并命令: bash

    运行

    复制代码
    git pull --rebase origin master
    • --rebase:以变基方式合并,保持提交历史线性,避免产生多余的 "合并提交"。
  2. 若合并时出现冲突(如本地和远程有同名文件),按提示解决冲突后,执行: bash

    运行

    复制代码
    git add .
    git rebase --continue
  3. 重新推送代码: bash

    运行

    复制代码
    git push -u origin master
方案 2:强制推送(简单粗暴,覆盖远程)

该方法会直接用本地代码覆盖远程仓库的所有内容,会删除远程仓库中已有的文件 (如README),适合远程仓库无重要内容的场景。

bash

运行

复制代码
git push -u origin master --force

注意:团队协作时禁止使用强制推送,避免覆盖他人代码。

方案 3:重新克隆(从零开始,避免冲突)

若本地项目未做重要修改,可删除本地仓库,重新克隆远程仓库后再放入项目文件。

  1. 删除本地travel文件夹(保留项目源码备份);

  2. 克隆远程仓库到本地: bash

    运行

    复制代码
    git clone git@gitee.com:im-ke-ke/travel-vue-test.git
  3. 将 Vue 项目的所有文件复制到克隆后的travel-vue-test文件夹中;

  4. 提交并推送: bash

    运行

    复制代码
    cd travel-vue-test
    git add .
    git commit -m 'project initialized'
    git push

预防建议

后续在码云创建仓库时,取消勾选「初始化仓库」 (不生成READMELICENSE),即可直接执行git push,避免此类冲突。

相关推荐
柳杉2 小时前
精选10套开源数据可视化大屏项目合集 | 从 3D 地球到数字孪生
前端·javascript·数据可视化
qhd吴飞2 小时前
ElementUI Table合并单元格后,勾选行时,数据错误问题
前端·javascript·elementui
easyboot2 小时前
vxetable的表格滚动条加粗功能
前端·javascript·vue.js
C澒2 小时前
供应链产研交付提效:样板间 2.0 从标准化到自动化的全链路落地实践
前端·ai编程
yangyanping201082 小时前
Vue入门到精通五之yarn部署项目
前端·javascript·vue.js
Luna-player2 小时前
npx create-vue 创建 Vue 3 项目的交互式配置界面
前端·javascript·vue.js
还是大剑师兰特2 小时前
const { proxy } = getCurrentInstance() 的正确使用方法
前端·javascript·vue.js
zhengzhengwang2 小时前
react18升级新特性
前端·javascript·react.js