git-workflow（Git 工作流）

Git 工作流技能

核心指令

第一步：检测文件变更

# 检查 Git 状态
git status

# 查看变更文件
git diff --name-only

第二步：添加文件

# 添加所有变更
git add .

# 或添加指定文件
git add <file1> <file2>

第三步：生成提交信息

根据变更内容自动生成提交信息：

# 提交信息格式
<type>: <description>

# 类型说明
feat: 新功能
fix: 修复 bug
docs: 文档更新
style: 代码格式
refactor: 重构
test: 测试
chore: 构建/工具

第四步：提交并推送

# 提交
git commit -m "提交信息"

# 推送
git push

示例

示例 1: 分析完成后自动提交

触发: 分析任务完成

操作:

1. 检测新生成的文件
2. 添加到 Git
3. 生成提交信息
4. 提交并推送

提交信息示例:

feat: 完成股票分析

- 分析 000657 中钨高新
- 生成三高股票筛选报告
- 保存到 Stock-Analysis 仓库

示例 2: 多仓库管理

触发: 需要提交到多个仓库

操作:

1. 识别文件所属仓库
2. 分别提交到对应仓库
3. 分别推送

仓库示例:

• Jarvis: 记忆、配置
• Stock-Analysis: 股票分析代码
• Amazon-Analyzer: 亚马逊运营工具

故障排除

错误 1: Git 未配置

错误消息: "Please tell me who you are"

解决方案:

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

错误 2: 推送失败

错误消息: "Authentication failed"

解决方案:

1. 检查 Git 凭据
2. 使用 Token 代替密码
3. 配置 SSH Key

错误 3: 冲突

错误消息: "CONFLICT (content)"

解决方案:

1. 查看冲突文件
2. 手动解决冲突
3. 标记为解决 git add <resolved_file>
4. 完成提交 git commit

最佳实践

提交频率

• 小改动：随时提交
• 大功能：功能完成后提交
• 每日结束：提交当日工作

提交信息

• 清晰简洁
• 使用现在时
• 首字母大写
• 不超过 50 字符

分支管理

• main/master: 主分支
• feature/*: 功能分支
• fix/*: 修复分支
• docs/*: 文档分支