1. 安装 Node.js
-
推荐下载 LTS 长期维护版(稳定),也可以选择 CURRENT 最新版
-
安装完成后,打开命令行(cmd),输入: bash
运行
node -v # 显示版本号,如 v7.10.1 表示安装成功 npm -v # 显示 npm 版本号,npm 是 Node 包管理工具
2. 准备代码仓库(码云 Gitee)
- 打开码云:http://gitee.com
- 注册账号并登录
- 创建一个私有仓库 ,命名为
travel,用于存储项目代码
3. 安装 Git
-
打开 Git 官网:https://git-scm.com/
-
下载并安装 Git
-
验证安装:在命令行输入 bash
运行
git --version # 显示版本号即成功 -
设置 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 规则排除,不会被提交:
🧐 为什么要忽略这些文件?
-
在
travel目录下打开 Git Bash -
查看本地仓库状态: bash
运行
git status -

❌ 报错含义
当前所在的文件夹 不是一个 Git 仓库(里面没有 .git 文件夹),所以无法执行 git status 等命令。
📌 出现原因
你现在的目录下:
5. 没有初始化 Git(git init)
6. 不是克隆下来的项目(没有 .git 目录)所以 Git 命令无法识别
7. 添加所有文件到暂存区: bash
运行
git add .
-
提交代码: bash
运行
git commit -m 'project initialized' -

-
✅ 提交成功了!
从输出可以看到:
-
你在
master分支完成了第一次提交,提交信息是:董文柯第一次提交 -
一共创建了 30 个文件,新增了 5090 行代码
-
所有项目文件(配置文件、Vue 组件、路由、样式等)都已经被成功记录到本地 Git 仓库里
-
从你的
.gitignore文件和提交日志来看,并不是所有文件都被提交了,核心原因如下:1. 已被提交的文件 ✅
这些是项目的核心代码和配置文件,已经被成功提交到 Git 仓库:
-
src/:你的 Vue 组件、页面、路由等业务代码 -
public/:静态资源(如 favicon.ico) -
配置文件:
.editorconfig、.gitattributes、.eslintrc.json、package.json等 -
README.md:项目说明文档 -
vite.config.js:Vite 构建工具配置 -
node_modules/:依赖包文件夹(体积巨大,由package.json记录,无需提交) -
.vscode/:VS Code 编辑器的本地配置(仅对你的电脑生效) -
package-lock.json:虽然你截图里有,但如果在.gitignore中被排除,也不会提交(不过通常建议提交这个文件以锁定依赖版本) -
node_modules/:体积非常大,且可以通过npm install重新生成,提交会浪费仓库空间和带宽。 -
编辑器配置 :
.vscode/这类文件是你的个人开发环境配置,不适合共享给其他开发者。 -
临时文件 :日志、缓存等文件也会被
.gitignore忽略,避免仓库混乱。 -
关联远程仓库并推送: 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/sTotal 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 等)时,能明显减少等待时间,避免下载失败。
注意事项 ⚠️
-
可选操作 :不是必须安装,你之前已经通过
npm config set registry切换了淘宝源,也能达到加速效果,cnpm只是更方便的客户端封装。 -
兼容性问题 :极少数情况下,
cnpm可能和某些包的依赖解析有细微差异,如果遇到问题,换回npm即可。 -
源地址更新 :现在淘宝镜像的新地址是
https://registry.npmmirror.com,老地址registry.npm.taobao.org也还能用,但推荐用新地址:bash
运行
npm install -g cnpm --registry=https://registry.npmmirror.com
总结
- 如果你平时下载 npm 包很慢、经常超时,建议安装 ,用
cnpm替代npm会更顺畅。 - 如果你已经切换了 registry,且下载速度没问题,也可以不安装 ,直接用
npm就行。

问题核心分析
该报错的本质是远程仓库(码云)与本地仓库的提交历史不一致 :你在码云创建仓库时,可能勾选了「初始化仓库」(自动生成README、LICENSE等文件),导致远程仓库已有提交记录,而本地是全新初始化的项目,Git 拒绝直接覆盖,要求先整合差异。
解决方案(按优先级排序,推荐方案 1)
方案 1:拉取并合并远程代码(最安全,保留远程文件)
该方法会将远程仓库的文件(如README)拉到本地,与你的 Vue 项目合并,适合需要保留远程初始化文件的场景。
-
执行拉取与合并命令: bash
运行
git pull --rebase origin master--rebase:以变基方式合并,保持提交历史线性,避免产生多余的 "合并提交"。
-
若合并时出现冲突(如本地和远程有同名文件),按提示解决冲突后,执行: bash
运行
git add . git rebase --continue -
重新推送代码: bash
运行
git push -u origin master
方案 2:强制推送(简单粗暴,覆盖远程)
该方法会直接用本地代码覆盖远程仓库的所有内容,会删除远程仓库中已有的文件 (如README),适合远程仓库无重要内容的场景。
bash
运行
git push -u origin master --force
注意:团队协作时禁止使用强制推送,避免覆盖他人代码。
方案 3:重新克隆(从零开始,避免冲突)
若本地项目未做重要修改,可删除本地仓库,重新克隆远程仓库后再放入项目文件。
-
删除本地
travel文件夹(保留项目源码备份); -
克隆远程仓库到本地: bash
运行
git clone git@gitee.com:im-ke-ke/travel-vue-test.git -
将 Vue 项目的所有文件复制到克隆后的
travel-vue-test文件夹中; -
提交并推送: bash
运行
cd travel-vue-test git add . git commit -m 'project initialized' git push
预防建议
后续在码云创建仓库时,取消勾选「初始化仓库」 (不生成README、LICENSE),即可直接执行git push,避免此类冲突。