SVN 提交（Commit）最全实战指南
（2025 年最新、最常用、最防坑的完整写法）
1. 标准提交 6 步法（99% 的情况都这么干）
# 第1步：确认你要提交的内容（最重要！）
svn status # 显示所有本地修改、添加、删除
svn diff # 看具体改了什么代码（强烈建议每次都看）
# 第2步：添加新文件（没加的话不会提交上去）
svn add src/newfile.cpp docs/readme.md --parents # --parents 自动创建目录
# 第3步：删除文件（物理删了要用 svn delete 才会上库）
svn delete src/oldfile.cpp
# 第4步：提交（推荐写清晰的提交信息）
svn commit -m "feat: 新增用户登录校验模块
fix: 修复订单超时自动取消的边界问题
docs: 更新接口文档"
# 第5步：提交完成后立刻更新（防止下次再冲突）
svn update
2. 最常用的一键提交写法（直接复制粘贴）
| 场景 | 推荐命令（直接用） |
|---|
| 常规提交（最常用） | svn ci -m "你的提交信息" |
| 添加所有新文件后提交 | svn add . --force && svn ci -m "消息" |
| 先看改动再决定要不要提交 | svn diff | less → 看完后 → svn ci -m "消息" |
| 提交指定文件 | svn ci src/utils.cpp include/config.h -m "优化工具类" |
| 提交整个项目（自动添加新文件） | svn ci -m "大提交" --depth infinity |
| 超级安全提交（推荐给新人） | svn status && svn diff --git | less && read -p "确认提交？(y/N)" ok && [ "$ok" = "y" ] && svn ci -m "消息" |
3. 提交信息规范（团队强制执行，写好这辈子都受用）
| 类型 | 前缀 | 示例 |
|---|
| 新功能 | feat: | feat: 支持微信小程序登录 |
| 修复 | fix: | fix: 修复订单金额小数精度丢失 |
| 文档 | docs: | docs: 更新 API 文档 v2.1 |
| 重构 | refactor: | refactor: 将用户模块抽离为独立服务 |
| 性能 | perf: | perf: 缓存热点数据，接口响应从 800ms → 120ms |
| 测试 | test: | test: 增加支付流程的集成测试 |
| 工具/配置 | chore: | chore: 升级 SVN 到 1.14，升级编译器版本 |
4. 常见错误与防坑技巧
| 错误场景 | 正确做法 |
|---|
| 忘记 add 新文件 | 用 svn status 看是否有 ? 号的文件 → svn add 它们 |
| 提交了不该提交的大文件（>10MB） | 先 svn delete → svn ci → 用 Git LFS 或外链方式存放 |
| 提交信息写成了“111”“改了bug” | 强制团队开启 pre-commit hook 检查提交信息（我可以给你现成的脚本） |
| 提交后发现错了 | 立刻 svn revert -R . 回滚本地 → 重新修改 → 再提交 |
| 想撤销上一次提交 | svn merge -c -REV . （REV 是你要撤销的版本号） → 再提交一次 |
5. 企业/团队最常用的一键提交脚本（直接保存为 svnci 命令）
# 保存为 /usr/local/bin/svnci 或 Windows 的 svnci.bat
#!/bin/bash
svn status > /tmp/svn_status_$$
if grep -q "^?" /tmp/svn_status_$$; then
echo "发现未添加的新文件，自动添加..."
svn add . --force
fi
echo "================================================================="
svn diff --git | less -R
echo "================================================================="
read -p "请输入提交信息（直接回车则取消）: " msg
if [ -n "$msg" ]; then
svn ci -m "$msg" && svn update
echo "提交成功！"
else
echo "已取消提交"
fi
rm -f //tmp/svn_status_$$
6. TortoiseSVN（Windows 图形化）提交方式
- 右键项目文件夹 → TortoiseSVN → Check for modifications
- 勾选要提交的文件（双击可查看 diff）
- 点“Commit” → 写好提交信息 → OK
现在你已经完全掌握 SVN 提交了！
把你现在的 svn status 贴出来，我可以直接告诉你最安全的一条提交命令。
