开发工具 on 吾爱主机

SVN命令行完全指南：从入门到实战

Fri, 26 Jun 2026 16:30:00 +0000

SVN 简介

Apache Subversion（SVN）是一个集中式版本控制系统，曾是最流行的版本控制工具。虽然 Git 已成为主流，但许多企业和遗留项目仍在使用 SVN。

SVN vs Git 核心区别：

特性	SVN	Git
架构	集中式	分布式
离线工作	❌ 不支持	✅ 完整支持
分支成本	较高	极低
学习曲线	低	中等
适用场景	二进制文件、大型文件	代码项目

安装 SVN

# Ubuntu/Debian
sudo apt install subversion

# CentOS/RHEL
sudo yum install subversion

# macOS
brew install subversion

# 验证安装
svn --version

基本操作

1. 检出仓库

# 检出整个仓库
svn checkout https://svn.example.com/repo/project
svn checkout https://svn.example.com/repo/project my-local-dir

# 检出指定版本
svn checkout -r 1234 https://svn.example.com/repo/project

# 简写形式
svn co https://svn.example.com/repo/project

2. 更新代码

# 更新到最新版本
svn update
svn up

# 更新到指定版本
svn update -r 1234

# 更新指定目录
svn update src/

3. 查看状态

# 查看工作副本状态
svn status
svn st

# 状态标识说明：
# ? 未版本控制
# A 已添加
# M 已修改
# D 已删除
# C 冲突
# ! 缺失
# ~ 类型改变

4. 添加文件

# 添加单个文件
svn add file.txt

# 添加目录
svn add src/

# 递归添加所有新文件
svn add --force .

# 添加文件到版本控制（仅调度，不会自动提交，需后续 svn commit）
svn add file.txt

5. 提交更改

# 提交所有更改
svn commit -m "提交说明"
svn ci -m "提交说明"

# 提交指定文件
svn commit file.txt -m "修改文件"

# 提交多个文件
svn commit file1.txt file2.txt -m "批量修改"

6. 删除文件

# 删除文件
svn delete file.txt
svn del file.txt
svn rm file.txt

# 删除并提交
svn delete file.txt -m "删除文件"

# 删除本地文件但保留版本控制
svn delete --keep-local file.txt

7. 移动/重命名

# 移动文件
svn move old.txt new.txt
svn mv old.txt new.txt
svn rename old.txt new.txt

查看信息

1. 查看日志

# 查看完整日志
svn log

# 查看最近N条日志
svn log -l 10

# 查看指定文件日志
svn log file.txt

# 查看详细日志
svn log -v

# 按日期筛选
svn log -r {2024-01-01}:{2024-12-31}

2. 查看差异

# 查看工作副本与仓库差异
svn diff

# 查看指定文件差异
svn diff file.txt

# 查看两个版本差异
svn diff -r 1234:1235

# 查看指定版本的变更
svn diff -c 1234

3. 查看文件内容

# 查看文件内容
svn cat file.txt

# 查看指定版本的文件内容
svn cat -r 1234 file.txt

# 查看文件信息
svn info file.txt

# 查看仓库信息
svn info

4. 查看列表

# 列出目录内容
svn list https://svn.example.com/repo/

# 递归列出
svn list -R https://svn.example.com/repo/

# 显示详细信息
svn list -v https://svn.example.com/repo/

分支与标签

1. 创建分支

# 标准目录结构方式
svn copy https://svn.example.com/repo/trunk \
 https://svn.example.com/repo/branches/feature-login \
 -m "创建feature-login分支"

# 本地方式
svn copy trunk branches/feature-login
svn commit -m "创建feature-login分支"

2. 切换分支

# 切换到分支
svn switch https://svn.example.com/repo/branches/feature-login

# 切换回主干
svn switch https://svn.example.com/repo/trunk

3. 合并分支

# 切换到目标分支（通常是trunk）
svn switch https://svn.example.com/repo/trunk

# 合并分支
svn merge https://svn.example.com/repo/branches/feature-login

# 解决冲突后提交
svn commit -m "合并feature-login分支"

# 查看合并信息
svn mergeinfo https://svn.example.com/repo/branches/feature-login

4. 创建标签

# 创建标签（标签是分支的只读副本）
svn copy https://svn.example.com/repo/trunk \
 https://svn.example.com/repo/tags/v1.0.0 \
 -m "创建v1.0.0标签"

冲突解决

1. 查看冲突

# 更新时出现冲突
svn update
# 输出：C file.txt

# 查看冲突状态
svn status
# 输出：C file.txt

2. 解决冲突

# 方式1：接受当前工作副本内容（手工解决冲突后常用）
svn resolve --accept working file.txt

# 方式2：接受本地版本
svn resolve --accept mine-full file.txt

# 方式3：接受服务器版本
svn resolve --accept theirs-full file.txt

# 方式4：手动编辑后标记解决
# 编辑 file.txt，解决冲突标记
svn resolve --accept working file.txt

3. 冲突标记

<<<<<<< .mine
你的修改
=======
服务器版本
>>>>>>> .r1234

高级操作

1. 版本回退

# 回退单个文件到指定版本
svn update -r 1234 file.txt

# 回退整个工作副本
svn update -r 1234

# 撤销已提交的修改（反向合并）
svn merge -r 1234:1233 .
svn commit -m "回退r1234的修改"

2. 忽略文件

# 设置忽略模式
svn propset svn:ignore "*.log" .
svn propset svn:ignore -F .svnignore .

# 递归设置
svn propset svn:global-ignores "*.o *.a" .

# 查看忽略设置
svn propget svn:ignore .

# 编辑忽略列表
svn propedit svn:ignore .

3. 属性操作

# 设置属性
svn propset svn:keywords "Author Date Rev" file.txt
svn propset svn:eol-style native file.txt
svn propset svn:mime-type image/png image.png

# 查看属性
svn proplist file.txt
svn propget svn:keywords file.txt

# 删除属性
svn propdel svn:keywords file.txt

4. 导出代码

# 导出干净代码（无.svn目录）
svn export https://svn.example.com/repo/trunk ./export

# 导出本地工作副本
svn export . ./clean-copy

5. 清理

# 清理工作副本锁
svn cleanup

# 删除未版本控制的文件
svn status | grep "^?" | awk '{print $2}' | xargs rm -rf

SVN 标准目录结构

repo/
├── trunk/ # 主开发线
│ ├── src/
│ └── ...
├── branches/ # 分支
│ ├── feature-login/
│ └── release-1.0/
└── tags/ # 标签（只读）
 ├── v1.0.0/
 └── v1.1.0/

常用别名配置

# ~/.bashrc 或 ~/.zshrc
alias ss='svn status'
alias su='svn update'
alias sci='svn commit -m'
alias sdiff='svn diff'
alias slog='svn log -l 10'
alias sinfo='svn info'

SVN 迁移到 Git

# 使用 git-svn
git svn clone https://svn.example.com/repo --stdlayout --no-metadata

# 作者映射
git svn clone https://svn.example.com/repo \
 --stdlayout \
 --authors-file=authors.txt \
 --no-metadata

# authors.txt 格式
# svnuser = Git User <git@email.com>

常见问题

1. 工作副本锁定

# 清理锁定
svn cleanup

# 如果不行，删除锁文件
find . -name "*.lock" -delete
svn cleanup

2. 无法提交

# 检查是否有冲突未解决
svn status | grep "^C"

# 解决冲突后
svn resolved file.txt
svn commit -m "解决冲突"

3. 版本号混乱

# 查看当前版本
svnversion

# 查看详细信息
svn info

总结

SVN 虽然不如 Git 流行，但在特定场景仍有价值：

二进制文件管理：SVN 对大文件支持更好
精细权限控制：支持目录级别的权限管理
简单易学：对新手更友好
企业遗留系统：许多企业仍在使用

掌握 SVN 命令对于维护遗留项目和特定场景仍然很有必要。

Git从入门到精通：完整命令与工作流教程

Fri, 26 Jun 2026 16:00:00 +0000

Git 简介

Git 是一个分布式版本控制系统，由 Linus Torvalds 于 2005 年创建，用于管理 Linux 内核开发。如今已成为全球最流行的版本控制工具。

Git 的核心特点：

分布式：每个开发者都有完整的代码历史
分支轻量：创建和切换分支几乎瞬间完成
数据完整：使用 SHA-1 保证数据完整性
暂存区设计：灵活控制提交内容

安装 Git

# Ubuntu/Debian
sudo apt install git

# CentOS/RHEL
sudo yum install git

# macOS
brew install git

# 验证安装
git --version

基础配置

# 设置用户信息
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

# 设置默认编辑器
git config --global core.editor vim

# 设置默认分支名
git config --global init.defaultBranch main

# 查看配置
git config --list

基本工作流

1. 初始化仓库

# 新建仓库
git init

# 克隆远程仓库
git clone https://github.com/user/repo.git
git clone git@github.com:user/repo.git # SSH 方式

2. 基本操作

# 查看状态
git status

# 添加文件到暂存区
git add file.txt # 添加单个文件
git add . # 添加所有变更
git add *.py # 添加匹配的文件
git add -p # 交互式添加（选择性暂存）

# 提交
git commit -m "feat: 添加新功能"
git commit -am "fix: 修复bug" # 添加并提交已跟踪文件
git commit --amend # 修改上次提交

# 查看日志
git log
git log --oneline # 简洁模式
git log --graph # 图形化分支
git log -5 # 最近5条
git log --author="name" # 按作者筛选
git log --since="2024-01-01" # 按日期筛选

3. 分支操作

# 查看分支
git branch # 本地分支
git branch -a # 所有分支
git branch -v # 最后提交信息

# 创建分支
git branch feature/login # 创建分支
git checkout -b feature/login # 创建并切换
git switch -c feature/login # Git 2.23+ 推荐方式

# 切换分支
git checkout main
git switch main # Git 2.23+ 推荐方式

# 合并分支
git merge feature/login
git merge --no-ff feature/login # 禁用快进合并

# 删除分支
git branch -d feature/login # 删除已合并分支
git branch -D feature/login # 强制删除

# 重命名分支
git branch -m old-name new-name

4. 远程操作

# 查看远程仓库
git remote -v

# 添加远程仓库
git remote add origin https://github.com/user/repo.git

# 推送
git push origin main
git push -u origin main # 设置上游并推送
git push --force # 强制推送（危险！）
git push --force-with-lease # 安全的强制推送

# 拉取
git fetch origin # 获取远程更新
git pull origin main # 获取并合并
git pull --rebase origin main # 获取并变基

# 删除远程分支
git push origin --delete feature/old

常用场景命令

撤销操作

# 撤销工作区修改
git checkout -- file.txt
git restore file.txt # Git 2.23+

# 撤销暂存
git reset HEAD file.txt
git restore --staged file.txt # Git 2.23+

# 撤销提交（保留修改）
git reset --soft HEAD~1

# 撤销提交（丢弃修改）
git reset --hard HEAD~1

# 回退到指定提交
git reset --hard abc1234

暂存工作

# 暂存当前修改
git stash
git stash save "描述信息"

# 查看暂存列表
git stash list

# 恢复暂存
git stash pop # 恢复并删除
git stash apply stash@{0} # 恢复不删除

# 删除暂存
git stash drop stash@{0}
git stash clear # 清空所有

标签管理

# 创建标签
git tag v1.0.0
git tag -a v1.0.0 -m "版本1.0.0"

# 查看标签
git tag
git tag -l "v1.*"

# 推送标签
git push origin v1.0.0
git push origin --tags # 推送所有标签

# 删除标签
git tag -d v1.0.0
git push origin --delete v1.0.0

查看差异

# 工作区 vs 暂存区
git diff

# 暂存区 vs 仓库
git diff --staged
git diff --cached

# 两个分支差异
git diff main..feature/login

# 文件差异
git diff HEAD -- file.txt

Git 工作流策略

1. Git Flow

适合大型项目，有明确的版本发布周期：

main ──────────────────────────●──●──●
 │ ↑ ↑
 └── develop ──●──●──●──●──●──┘ │
 │ ↑ ↑ │
 └── feature/login ─┘ │
 │ │
 └── release/1.0 ────────────┘
 │
 └── hotfix/fix-bug ─────────┘

分支说明：

main：生产环境代码
develop：开发主线
feature/*：功能分支
release/*：发布准备
hotfix/*：紧急修复

2. GitHub Flow

适合持续部署的项目：

main ──●──●──●──●──●──●
 │ ↑ ↑ ↑
 └────┘ │ │
 └────────┘ │
 └────────────┘

流程：

从 main 创建功能分支
开发完成后提交 Pull Request
代码审查通过后合并到 main
自动部署

3. Trunk-Based Development

适合高频发布：

main ──●──●──●──●──●──●──●──●
 │ ↑ ↑ ↑ ↑
 └────┘ │ │ │
 └────────┘ │ │
 └────────────┘ │
 └────────────────┘

特点：

所有开发在 main 分支进行
短生命周期的功能分支（< 1天）
依赖特性开关（Feature Flags）

Git 高级技巧

1. 交互式变基

# 压缩最近3个提交
git rebase -i HEAD~3

# 在编辑器中：
# pick abc1234 第一次提交
# squash def5678 第二次提交
# squash ghi9012 第三次提交

2. Cherry-Pick

# 将指定提交应用到当前分支
git cherry-pick abc1234

# 应用多个提交
git cherry-pick abc1234 def5678

3. Bisect（二分查找）

# 开始二分查找
git bisect start

# 标记当前版本有问题
git bisect bad

# 标记某个版本正常
git bisect good v1.0.0

# Git 自动切换版本，测试后标记
# 测试通过
git bisect good
# 测试失败
git bisect bad

# 找到问题提交后结束
git bisect reset

4. 子模块

# 添加子模块
git submodule add https://github.com/user/lib.git libs/lib

# 克隆含子模块的仓库
git clone --recursive https://github.com/user/project.git

# 更新子模块
git submodule update --init --recursive

Git 配置优化

.gitconfig 推荐配置

[alias]
 st = status
 co = checkout
 br = branch
 ci = commit
 lg = log --oneline --graph --all --decorate
 last = log -1 HEAD
 unstage = reset HEAD --
 amend = commit --amend --no-edit
 wip = stash save "WIP"
 
[color]
 ui = auto
 
[core]
 autocrlf = input # Linux/macOS
 # autocrlf = true # Windows
 
[pull]
 rebase = true
 
[push]
 default = current
 
[merge]
 ff = false
 
[diff]
 tool = vscode
 
[difftool "vscode"]
 cmd = code --wait --diff $LOCAL $REMOTE

.gitignore 模板

# 编译产物
*.class
*.o
*.pyc
__pycache__/
build/
dist/

# IDE
.idea/
.vscode/
*.swp
*.swo

# 系统文件
.DS_Store
Thumbs.db

# 依赖
node_modules/
vendor/
.venv/

# 环境变量
.env
.env.local

# 日志
*.log
logs/

# 临时文件
tmp/
temp/

常见问题解决

1. 误删文件恢复

# 恢复最近一次提交的文件
git checkout HEAD -- file.txt

# 从暂存区恢复
git checkout -- file.txt

2. 合并冲突

# 查看冲突文件
git status

# 解决冲突后
git add file.txt
git commit

3. 误操作回退

# 查看操作历史
git reflog

# 回退到指定操作
git reset --hard HEAD@{2}

4. 大文件清理

# 从历史中删除大文件
git filter-branch --force --index-filter \
 'git rm --cached --ignore-unmatch path/to/large/file' \
 --prune-empty --tag-name-filter cat -- --all

# 或使用 BFG Repo-Cleaner
java -jar bfg.jar --strip-blobs-bigger-than 10M repo.git

总结

Git 是现代开发的必备工具，核心要点：

掌握基本操作：add、commit、push、pull、merge
理解分支策略：根据团队规模选择合适的工作流
善用高级功能：stash、rebase、cherry-pick
配置优化：设置别名、.gitignore、merge 策略
安全操作：避免 --force，使用 --force-with-lease

建议每天练习，从简单项目开始，逐步掌握高级功能。