uni-app项目初始化前必须先配置.gitignore文件,否则git init后会将/node_modules和/unpackage/dist等可再生目录提交至仓库,导致仓库臃肿和协作冲突。

uni-app项目初始化前必须配好 .gitignore
不加 .gitignore 就直接 git init,后续会把 /node_modules 和 /unpackage/dist 一起提交,不仅仓库臃肿,还容易引发协作冲突。
在项目根目录手动创建 .gitignore 文件,写入这两行:
.node_modules /unpackage/dist
/node_modules 是 npm 安装的依赖,体积大、平台相关、可重装;/unpackage/dist 是 uni-app 构建时生成的临时产物,每次打包都会变,绝对不能进 Git。
其他可选忽略项(按需添加):
-
/dist(如果用了 H5 自定义构建输出) *.log-
local.env或.env.local(含敏感配置)
Windows 下用 HBuilderX 提交前得先配 SSH 或 HTTPS 认证
很多人点【git提交】后弹出错误:disconnected: no supported authentication methods available (server sent: publickey)——这说明 Git 没法用 SSH 连远程仓库。
解决路径分两种:
- 用 HTTPS 方式:克隆地址写成
https://gitee.com/xxx/yyy.git,首次 push 时会弹窗要账号密码(或个人访问令牌) - 用 SSH 方式(推荐):在 Git Bash 中运行
ssh-keygen -t rsa -C "your@email.com",然后把生成的~/.ssh/id_rsa.pub内容粘贴到 Gitee/GitHub 的 SSH Keys 设置页
配完别忘了验证:ssh -T git@gitee.com(或 git@github.com),看到 Welcome to Gitee.com 才算成功。
使用 GitHub Next 的 CI Doctor 工作流来监视 GitHub Actions 运行、拉取失败日志、追踪重复模式,并打开带有具体下一步操作的调查问题。这是供代理作为 CI 失败调查员使用的,而不是用于将 GitHub Agentic Workflows 列为产品。
git add . 后 git commit 报 config missing 怎么办
这是 Git 的基础校验:没设用户名和邮箱,不允许提交。HBuilderX 右键【git提交】失败,通常就是这个原因。
执行这两条命令(全局生效,只需一次):
git config --global user.email "you@example.com" git config --global user.name "Your Name"
注意:--global 表示对本机所有仓库生效;如果只想配当前项目,去掉该参数,在项目根目录下运行即可。
验证是否生效:git config user.email 和 git config user.name 应该返回对应值。
多端项目合分支前务必检查条件编译块
uni-app 的 #ifdef MP-WEIXIN、#ifdef H5 等条件编译代码,很容易在 merge 时被意外删掉或漏掉平台适配,导致某端白屏或功能缺失。
合入 dev 或 main 前建议手动扫一遍:
- 搜索
#ifdef和#endif是否成对出现 - 确认新增 API 是否有 fallback(比如微信登录失败时是否降级到手机号登录)
- 检查
pages.json里平台专属字段(如mp-weixin下的permission)是否还在
这不是 Git 能自动保障的事,得靠人眼+团队约定。

















