uniapp小程序项目创建git仓库并将本地代码上传

一、前置准备

1. 安装 Git：前往 Git 官网 下载对应系统版本并安装，安装后打开终端 / 命令行，执行 git --version 验证是否安装成功（显示版本号即正常）。
2. 创建远程 Git 仓库：登录代码托管平台（GitHub/Gitee/GitLab），新建空白仓库（不要勾选 “初始化仓库”，避免自动生成 README / 忽略文件导致冲突），复制仓库的 HTTPS/SSH 地址（推荐 SSH，免每次输密码）。
3. 检查项目结构：确保 Uniapp 项目根目录下无多余缓存文件，核心结构如下（示例）：

   uniapp-mini/
   ├── pages/          // 页面目录
   ├── static/         // 静态资源
   ├── App.vue         // 根组件
   ├── main.js         // 入口文件
   ├── manifest.json   // 小程序配置
   └── pages.json      // 页面路由

   二、本地初始化 Git 仓库

4. 打开项目目录：终端 / 命令行进入 Uniapp 项目根目录（例：cd /Users/xxx/uniapp-mini 或 cd D:\projects\uniapp-mini）。
5. 初始化 Git：执行以下命令初始化本地仓库（首次执行）：

   git init  # 初始化本地Git仓库，生成.git隐藏文件夹

   创建.gitignore 文件（关键）：Uniapp 项目有大量无需上传的文件（如编译产物、缓存、编辑器配置），需创建.gitignore文件过滤，避免仓库臃肿。在项目根目录新建.gitignore文件，粘贴以下内容（适配 Uniapp + 小程序）：

   # Uniapp编译产物
   unpackage/
   # 小程序开发者工具缓存
   .sitemap.json
   .eslintcache
   # Node_modules（若项目依赖npm）
   node_modules/
   # 编辑器配置（VSCode）
   .vscode/
   .idea/
   *.swp
   *.swo
   # 系统缓存
   .DS_Store
   Thumbs.db
   # 环境变量文件
   .env*

   三、关联远程仓库并提交代码

6. 添加远程仓库地址：将本地仓库关联到第一步复制的远程仓库地址（替换<远程仓库地址>）

   # HTTPS方式（需输入账号密码）
   git remote add origin https://gitee.com/xxx/uniapp-mini.git
   # SSH方式（推荐，需提前配置SSH密钥）
   git remote add origin git@gitee.com:xxx/uniapp-mini.git

   验证关联是否成功：git remote -v（显示 origin 对应地址即正常）。

暂存并提交本地代码：

git add .  # 暂存所有未忽略的文件（注意末尾的点）
# 首次提交，备注清晰（可自定义）
git commit -m "init: 初始化uniapp小程序项目，提交基础代码"

✅ 常见问题：git add . 无反应？检查.gitignore是否误过滤核心文件，或执行 git add --force 文件名 强制添加（不推荐）。

推送代码到远程仓库：首次推送需指定分支（默认 main/master，根据远程仓库分支名调整）：

# 主流平台默认分支为main
git push -u origin main
# 若远程分支是master（旧版Git）
git push -u origin master