uni-app 项目源码托管指南：从零开始将项目上传至 Gitee

将 uni-app 项目源码托管到 Gitee 上进行管理，可以按照以下步骤操作：

步骤 1：在 Gitee 上创建仓库

1. 登录 Gitee

   • 访问 Gitee，使用你的账号登录。如果没有账号，先注册一个。

2. 创建新仓库

   • 点击页面右上角的 “+” 按钮，选择 “新建仓库”。
   • 填写仓库信息：
     • 仓库名称：例如 uni-app-project。
     • 仓库描述：可选，填写项目简介。
     • 可见性：选择 公开 或 私有（私有仓库需要 Gitee 会员）。
     • 初始化仓库：可以选择 不初始化，后续通过命令行上传代码。
   • 点击 创建。

步骤 2：初始化本地 Git 仓库

1. 安装 Git

   • 如果本地没有安装 Git，先下载并安装：Git 下载地址。

2. 初始化 Git 仓库

   • 打开终端（命令行工具），进入你的 uni-app 项目根目录：

     cd /path/to/your/uni-app-project
     

   • 初始化 Git 仓库：

     git init
     

3. 添加文件到暂存区

   • 将所有文件添加到 Git 暂存区：

     git add .
     

4. 提交更改

   • 提交代码到本地仓库：

     git commit -m "Initial commit"
     

步骤 3：关联 Gitee 远程仓库

1. 获取 Gitee 仓库地址

   • 在 Gitee 仓库页面，点击 “克隆/下载”，复制仓库的 HTTPS 或 SSH 地址（例如：https://gitee.com/your-username/uni-app-project.git）。

2. 添加远程仓库

   • 在终端中运行以下命令，将 Gitee 仓库添加为远程仓库：

     git remote add origin https://gitee.com/your-username/uni-app-project.git
     

3. 推送代码到 Gitee

   • 将本地代码推送到 Gitee 远程仓库：

     git push -u origin master
     

   • 如果是第一次推送，可能需要输入 Gitee 账号的用户名和密码。

步骤 4：后续代码管理

1. 拉取最新代码

   • 如果团队其他成员更新了代码，可以通过以下命令拉取最新代码：

     git pull origin master
     

2. 提交新更改

   • 修改代码后，按照以下步骤提交：

     git add .
     git commit -m "描述你的更改"
     git push origin master
     

3. 分支管理

   • 如果需要开发新功能，可以创建新分支：

     git checkout -b feature/new-feature
     

   • 开发完成后，合并到主分支：

     git checkout master
     git merge feature/new-feature
     git push origin master
     

步骤 5：Gitee 项目管理

1. 设置仓库信息

   • 在 Gitee 仓库页面，可以设置仓库描述、README、LICENSE 等信息。

2. 协作与权限管理

   • 如果需要团队协作，可以在仓库设置中添加成员，并分配权限（如开发者、管理员）。

3. 使用 Issues 和 Pull Requests

   • 通过 Issues 跟踪任务和问题。
   • 通过 Pull Requests 进行代码审核和合并。

注意事项

1. 忽略文件

   • 在 uni-app 项目中，有些文件不需要上传（如 node_modules、unpackage 等），可以在项目根目录创建 .gitignore 文件，添加以下内容：

     node_modules/
     unpackage/
     .DS_Store
     

2. SSH 配置（可选）

   • 如果使用 SSH 方式推送代码，需要先配置 SSH 密钥：
     • 生成 SSH 密钥：

       ssh-keygen -t rsa -C "your-email@example.com"
       

     • 将公钥（~/.ssh/id_rsa.pub）添加到 Gitee 的 SSH 公钥管理 中。

通过以上步骤，你的 uni-app 项目源码就可以成功托管到 Gitee 上进行管理了！