话不多说，直接上操作！

创建仓库

安装git

官网：https://git-scm.com/

本地操作

• 打开终端

  右键点击你的项目根目录如 VIEW_PAGE → 选择“在终端中打开“

• 初始化仓库

  git init
  

• 关联远程仓库

  git remote add origin 你的仓库地址，这个仓库地址就是你创建仓库以后会自动生成的地址，直接复制即可
  

• 添加文件到暂存区

  git add .  # 提交全部文件（包括dist/assets/img中的图片）
  

• 提交代码

  git commit -m "首次提交：项目基础框架+资产图片"
  

• 强制推送（确保覆盖远程初始状态）

  git push -f origin master  # Gitee旧仓库默认分支为master
  

验证结果

• 刷新Gitee仓库页面 → 确认 dist、assets/img 等目录结构完整
• 检查中文图片文件，是否正常显示文件名和内容

避坑指南

• 中文文件名

  出现乱码、执行：

  git config --global core.quotepath false
  

  建议后续改用英文命名（如 delivery_stock.png）

• 忽略无用文件

  在 VIEW_PAGE 根目录创建 .gitignore，内容：

  node_modules/
  .DS_Store
  *.log
  

• 分支冲突

  若提示“无法合并”，先拉取远程代码：

  git pull origin master --allow-unrelated-histories
  

日常更新流程

# 每次修改代码后
git add .
git commit -m "更新描述"
git push  # 首次后无需 -f

报错解决

1、错误信息：

error: src refspec master does not match any
error: failed to push some refs to 'https://gitee.com/gitee_203742/viewPage.git'

错误原因：

• 本地主分支名不是 master（通常为 main），但推送命令仍使用 git push origin master
• 本地仓库尚未创建任何提交（空仓库无法匹配分支）

解决办法：

• 查看本地分支

  在 [VIEW_PAGE] 目录打开终端，执行

  git branch
  

  git branch
  

  • 若显示 * main → 说明主分支为 main
  • 若无输出 → 本地尚未提交任何代码

• 推送正确分支

  # 情况一：主分支为 main
  git push origin main
  
  # 情况二：首次提交（无分支）
  git add .
  git commit -m "首次提交"
  git branch -M main  # 强制重命名分支为 main
  git push origin main
  

• 强制同步远程分支（若已存在冲突）

  git push -f origin main
  

2、错误信息：

fatal: The current branch main has no upstream branch.
To push the current branch and set the remote as upstream, use

    git push --set-upstream origin main

To have this happen automatically for branches without a tracking
upstream, see 'push.autoSetupRemote' in 'git help config'.

错误描述：提示表明本地分支 main 尚未与远程分支建立关联。要解决这个问题，你可以使用以下命令将本地分支推送到远程仓库并设置上游分支

解决办法：

git push --set-upstream origin main
#简写
git push -u origin main

这两条命令的作用是相同的：它们会把当前本地分支推送到远程仓库，并将其与远程分支关联起来。这样，在未来的推送中，你就可以直接使用 git push 而无需额外参数。如果在执行上述命令后仍遇到问题，请确保你的SSH密钥已正确配置或尝试通过HTTPS方式推送代码。

3、报错信息：

error: remote origin already exists.

报错描述：这个错误提示表明你已经添加了一个名为 origin 的远程仓库

解决办法：

更改现有的 origin 远程仓库的URL

git remote set-url origin https://gitee.com/gitee_213788742/Paogrom.git