uni-app项目上传至gitee方法详细教程

1. 准备工作

1.1 安装 Git
下载并安装 Git：前往 Git 官网，根据操作系统下载安装包。
配置用户名和邮箱（需与 Gitee 账号一致）：

git config --global user.name "你的Gitee用户名"
git config --global user.email "你的Gitee注册邮箱"

1.2 创建 Gitee 仓库
登录 Gitee，点击右上角「+」→「新建仓库」。
填写仓库名称（如 uniapp-project），选择「公开」或「私有」，其他选项保持默认。
创建完成后，复制仓库的 SSH 或 HTTPS 地址（推荐使用 SSH，避免频繁输入账号密码）。

2. 本地项目关联 Gitee 仓库

2.1 初始化本地 Git 仓库
进入 Uniapp 项目根目录（含 pages.json 的目录），右键打开命令行，执行：

# 初始化本地仓库
git init

# 添加所有文件到暂存区（注意排除 node_modules 等无用文件）
git add .
# 或手动创建 .gitignore 文件排除不需要提交的目录（推荐）
# 示例 .gitignore 内容：
node_modules/
unpackage/dist/

2.2 提交本地代码

# 提交到本地仓库
git commit -m "初次提交：初始化Uniapp项目"

2.3 关联远程仓库

# 添加远程仓库地址（替换为你的Gitee仓库地址）
git remote add origin git@gitee.com:你的用户名/仓库名.git
# 示例：
git remote add origin git@gitee.com:john/uniapp-project.git

3. 推送代码到 Gitee

3.1 首次推送

# 推送代码到Gitee的master分支（-u表示关联默认远程分支）
git push -u origin master

若使用 HTTPS 地址，首次推送需输入 Gitee 账号密码。
若使用 SSH 地址但未配置密钥，需先生成SSH密钥并添加到 Gitee 账户（若失败重新进行步骤5）。

4. 验证提交结果

1.打开 Gitee 仓库页面，刷新后应看到项目文件已上传。
2.后续代码修改后，重复以下流程：

git add .
git commit -m "提交描述"
git push

5.常见问题

5.1 SSH 连接失败：
检查 SSH 密钥是否已添加到 Gitee 账户。
测试连接：ssh -T git@gitee.com，显示 Welcome to Gitee.com! 表示成功。
5.2 推送冲突：
若远程仓库已有文件（如初始化时勾选了README），先执行：

git pull origin master --allow-unrelated-histories
git push -u origin master

5.3 仓库地址错误：
修改远程地址：git remote set-url origin 新地址
5.4 SSH配置不成功，权限被拒绝

一、生成 SSH 密钥对
1.打开终端（Windows 用户使用 Git Bash）。
2.执行命令生成密钥（替换为你的 Gitee 邮箱）：

ssh-keygen -t ed25519 -C "your_email@example.com"

提示保存路径时，直接按回车使用默认路径（~/.ssh/id_ed25519）。
若提示输入密码（passphrase），可留空直接回车（或设置一个易记的密码）。
3.查看生成的公钥：

cat ~/.ssh/id_ed25519.pub

复制输出的全部内容（以 ssh-ed25519 开头，包含邮箱的字符串）。
二、将公钥添加到 Gitee 账户
1.登录 Gitee，点击右上角头像 → 「设置」 → 「SSH 公钥」。
2.填写信息：
标题：自定义（如 My PC）
公钥：粘贴复制的 id_ed25519.pub 内容
3.点击 「确定」 完成添加。
三、测试 SSH 连接
1.终端执行连接测试：

ssh -T git@gitee.com

首次连接会提示是否信任主机，输入 yes 回车。
成功响应：Welcome to Gitee.com, YourUsername!
2.若仍失败：
检查公钥是否完整粘贴（开头结尾无多余空格）。
确保执行 ssh-add 加载私钥：

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

四、检查远程仓库地址
1.确认远程仓库地址是否为 SSH 格式：

git remote -v

正确格式：git@gitee.com:用户名/仓库名.git
错误格式：https://gitee.com/用户名/仓库名.git（HTTPS 地址需账号密码，与 SSH 无关）
2.若地址错误，修改为 SSH 地址：

git remote set-url origin git@gitee.com:用户名/仓库名.git

五、重新推送代码
再次执行推送命令：

git push -u origin master

📌 其他可能的问题
1.文件权限问题（Linux/macOS）

chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519

2.多个密钥冲突：
若已存在其他密钥（如 id_rsa），需在 ~/.ssh/config 中指定密钥：

Host gitee.com
  HostName gitee.com
  IdentityFile ~/.ssh/id_ed25519

3.防火墙或代理限制：
确保端口 22 未被封锁（企业网络可能限制 SSH）。

完成以上步骤后，即可正常推送代码到 Gitee 仓库。