docs: 添加Git更新说明文档
This commit is contained in:
130
Git更新说明.md
Normal file
130
Git更新说明.md
Normal file
@@ -0,0 +1,130 @@
|
|||||||
|
# Git更新说明文档
|
||||||
|
|
||||||
|
## 一、仓库信息
|
||||||
|
|
||||||
|
**远程仓库地址**: `http://lmhrt.cn:6771/zou/Radar.git`
|
||||||
|
**默认分支**: `main`
|
||||||
|
|
||||||
|
## 二、更新前准备
|
||||||
|
|
||||||
|
### 1. 检查当前状态
|
||||||
|
```bash
|
||||||
|
git status
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 查看远程仓库配置
|
||||||
|
```bash
|
||||||
|
git remote -v
|
||||||
|
```
|
||||||
|
|
||||||
|
确保远程仓库地址正确,应该显示:
|
||||||
|
```
|
||||||
|
origin http://lmhrt.cn:6771/zou/Radar.git (fetch)
|
||||||
|
origin http://lmhrt.cn:6771/zou/Radar.git (push)
|
||||||
|
```
|
||||||
|
|
||||||
|
## 三、更新流程
|
||||||
|
|
||||||
|
### 1. 拉取最新代码(可选)
|
||||||
|
如果需要获取远程仓库的最新更改:
|
||||||
|
```bash
|
||||||
|
git pull origin main
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 添加更改
|
||||||
|
将修改的文件添加到暂存区:
|
||||||
|
```bash
|
||||||
|
git add .
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 提交更改
|
||||||
|
```bash
|
||||||
|
git commit -m "提交说明"
|
||||||
|
```
|
||||||
|
|
||||||
|
**提交说明建议格式**:
|
||||||
|
- 功能添加:`feat: 添加XXX功能`
|
||||||
|
- 修复问题:`fix: 修复XXX问题`
|
||||||
|
- 代码优化:`refactor: 优化XXX代码`
|
||||||
|
- 文档更新:`docs: 更新XXX文档`
|
||||||
|
|
||||||
|
### 4. 推送代码
|
||||||
|
```bash
|
||||||
|
git push origin main
|
||||||
|
```
|
||||||
|
|
||||||
|
## 四、分支管理(可选)
|
||||||
|
|
||||||
|
### 创建新分支
|
||||||
|
```bash
|
||||||
|
git checkout -b 分支名称
|
||||||
|
```
|
||||||
|
|
||||||
|
### 切换分支
|
||||||
|
```bash
|
||||||
|
git checkout 分支名称
|
||||||
|
```
|
||||||
|
|
||||||
|
### 合并分支
|
||||||
|
```bash
|
||||||
|
git checkout main
|
||||||
|
git merge 分支名称
|
||||||
|
```
|
||||||
|
|
||||||
|
## 五、常见问题及解决方案
|
||||||
|
|
||||||
|
### 1. 推送失败 - 权限问题
|
||||||
|
**错误信息**:`could not lock config file C:/Users/xxx/.gitconfig: Permission denied`
|
||||||
|
|
||||||
|
**解决方案**:使用 `--no-verify` 参数
|
||||||
|
```bash
|
||||||
|
git push -u origin main --no-verify
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 推送失败 - 冲突问题
|
||||||
|
**错误信息**:`failed to push some refs`
|
||||||
|
|
||||||
|
**解决方案**:先拉取远程代码,解决冲突后再推送
|
||||||
|
```bash
|
||||||
|
git pull origin main --rebase
|
||||||
|
git push origin main
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 远程仓库地址变更
|
||||||
|
**解决方案**:
|
||||||
|
```bash
|
||||||
|
git remote remove origin
|
||||||
|
git remote add origin http://lmhrt.cn:6771/zou/Radar.git
|
||||||
|
git push -u origin main
|
||||||
|
```
|
||||||
|
|
||||||
|
## 六、项目结构说明
|
||||||
|
|
||||||
|
```
|
||||||
|
├── src/
|
||||||
|
│ ├── main.cpp # 主程序
|
||||||
|
│ ├── radar_manager.cpp # 雷达数据处理
|
||||||
|
│ ├── radar_manager.h # 雷达管理器头文件
|
||||||
|
│ ├── wifi_manager.cpp # WiFi管理
|
||||||
|
│ └── wifi_manager.h # WiFi管理器头文件
|
||||||
|
├── platformio.ini # PlatformIO配置
|
||||||
|
├── data_formats_explanation.md # 数据格式说明
|
||||||
|
└── 传感器数据.txt # 传感器数据示例
|
||||||
|
```
|
||||||
|
|
||||||
|
## 七、更新注意事项
|
||||||
|
|
||||||
|
1. **代码规范**:保持代码风格一致,添加必要的注释
|
||||||
|
2. **测试验证**:更新后确保编译通过,功能正常
|
||||||
|
3. **提交信息**:使用清晰的提交信息,便于后续维护
|
||||||
|
4. **备份重要文件**:对关键配置文件进行备份
|
||||||
|
5. **版本控制**:定期提交,避免一次性提交过多更改
|
||||||
|
|
||||||
|
## 八、联系信息
|
||||||
|
|
||||||
|
如果遇到Git相关问题,请联系项目维护人员。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**最后更新时间**:2026-03-03
|
||||||
|
**文档版本**:v1.0
|
||||||
Reference in New Issue
Block a user