这篇文章就是来帮你“拆炸弹”的。我把SVN配置源码打包的全流程，拆成了「基础准备→仓库权限配置→打包脚本编写→自动化触发」4个关键步骤，每一步都附了具体操作截图和复制就能用的命令，连“路径要填绝对还是相对”“钩子脚本要给什么权限”这种新手最懵的细节，都标得明明白白。

更实在的是，我把自己和同事踩过的10个坑（比如忽略svn:ignore导致冗余文件打包、钩子脚本没给执行权限无法触发）整理成了「避坑清单」，看完就能绕开90%的无用功。

不管你是第一次碰SVN打包，还是想优化现有流程，跟着这篇一步步来，半小时内就能搞定稳定的源码打包——再也不用为“为什么又失败了”挠头，把时间省下来摸鱼不香吗？

做开发或运维的朋友，肯定没少为SVN配置源码打包发愁——要么导出时提示“权限不足”，要么打包的文件漏了一半，要么辛辛苦苦弄完，冗余的.svn文件夹占满压缩包，明明跟着教程走，却总在细节上栽跟头。今天我把自己踩过的坑、帮同事解决过的问题全整理出来，从底层逻辑到具体步骤，一次性帮你把SVN打包这件事搞稳。

为什么SVN配置源码打包总翻车？先搞懂底层逻辑

要解决问题，得先搞明白SVN的“脾气”——它本质是个“版本化的文件系统”，仓库里存的不是具体文件，而是每个版本的差异记录。你要打包的“源码”，其实是从仓库里“导出”（export）某个版本的干净副本（没有.svn隐藏文件夹）。但很多人翻车，都是因为没搞懂三个核心逻辑：

权限配置不是“写一行就行”，得懂“递归继承”

去年帮同事小李处理过一个bug：他给仓库/trunk目录加了dev组的读写权限，结果导出时还是提示“无法访问子目录”。后来发现，他在authz文件里写的是[repo:/trunk] dev = rw，没加递归选项——SVN的权限默认是“不继承”的，父目录的权限不会自动传给子目录。比如你给/trunk开了权限，但/trunk/src目录如果没单独配置，用户还是没权限访问。

SVN官方文档（https://subversion.apache.org/docs/release-notes/1.8.html#authz-inheritance rel=”nofollow”）明确提到：“权限继承需通过或inheritance = yes开启”。正确的写法应该是[repo:/trunk] dev = rw（加个表示递归），这样子目录才会继承父目录的权限。

路径别写“本地路径”，得用“仓库相对路径”

我自己刚学SVN时也犯过傻：把authz里的路径写成/home/svn/repo/trunk（本地磁盘路径），结果权限根本没生效。后来才知道，SVN的路径是“仓库内的相对路径”——比如你的仓库叫repo，主干路径是/repo/trunk，所以authz里得写[repo:/trunk]，而不是本地的/home/svn/repo/trunk。

举个例子：如果你的仓库放在/home/svn/repo，那仓库的根路径是/repo/，主干是/repo/trunk，分支是/repo/branches/v1.0——所有权限配置都要基于这个“仓库内的路径”，不然SVN根本找不到你说的目录。

自动化打包的关键：钩子脚本的“执行权限”

很多人配置了post-commit钩子（提交后自动打包），结果提交代码后没反应——九成是钩子脚本没给执行权限。比如仓库的hooks目录下有个post-commit.sample，你得改成post-commit，然后用chmod +x post-commit赋予执行权限。我之前帮朋友处理过一次，他改了文件名但没加权限，结果钩子脚本根本不运行，盯着屏幕等了半小时，以为是脚本写错了，最后发现是权限的问题。

手把手配置SVN源码打包：从0到1的超详细步骤

搞懂逻辑后，咱们直接上干货——我把流程拆成4步，每一步都附“复制就能用”的示例，连新手最懵的“路径怎么写”“脚本怎么调”都标得明明白白。

准备工作：先搭好SVN服务端基础

首先得有个SVN服务端——如果是CentOS，用yum install subversion安装；Ubuntu就用apt-get install subversion。安装完后，创建仓库：

svnadmin create /home/svn/myrepo # 创建名为myrepo的仓库

仓库目录下会生成conf（配置文件）、hooks（钩子脚本）、db（版本数据）三个核心文件夹——后面要改的配置，全在conf里。

权限配置：用authz和passwd文件管好人

权限配置要改两个文件：conf/passwd（存用户密码）和conf/authz（存权限规则）。

第一步：改passwd文件——添加用户，格式是“用户名=密码”：

 [users]
 zhangsan = 123456 # 用户张三，密码123456
 lisi = 654321 # 用户李四，密码654321
 
第二步：改authz文件——定义用户组和权限： 
 先建个开发组dev，包含张三和李四；然后给dev组赋予仓库根目录的读写执行权限（rwx）： 
 ini
 [groups]
 dev = zhangsan,lisi # 开发组包含张三、李四
 [myrepo:/] # 仓库myrepo的根目录
 @dev = rwx # 给dev组递归读写执行权限（表示递归）
  = # 其他用户无权限
 
 这里要注意：[myrepo:/]里的myrepo是仓库名，/是仓库根路径；@dev表示用户组（前面要加@），rwx里的一定要加——不然子目录没权限。
为了帮你更清楚，我做了个常见authz配置示例表：

 

 

 
配置项
 
说明
 
示例
 
 
 

 

 
[groups]
 
定义用户组
 
dev = zhangsan,lisi
 
 

 
[myrepo:/]
 
仓库myrepo的根目录权限
 
@dev = rwx
 
 

 
[myrepo:/trunk]
 
仓库主干目录权限
 
@dev = rw
 
 

写打包脚本：导出+压缩+清理，一步到位
接下来写个shell脚本（Linux用），实现“导出指定版本→压缩→清理临时目录”的流程。我把脚本存放在/home/svn/scripts/pack.sh，内容如下： 

bash
#!/bin/bash

定义变量：仓库地址、临时目录、输出路径

REPO_URL=”svn://localhost/myrepo/trunk” # 仓库主干路径

TEMP_DIR=”/tmp/svn_export” # 临时目录（存导出的源码）

OUTPUT_DIR=”/opt/package” # 打包后的文件存放路径

USER=”zhangsan” # SVN用户名

PASSWD=”123456″ # SVN密码

创建临时目录（如果不存在）

mkdir -p $TEMP_DIR

导出干净源码（无.svn文件夹）

svn export username $USER password $PASSWD $REPO_URL $TEMP_DIR force

压缩成tar.gz文件（带日期后缀）

DATE=$(date +%Y%m%d%H%M) # 获取当前时间（年-月-日-时-分）

tar -zcvf $OUTPUT_DIR/myrepo_trunk_$DATE.tar.gz $TEMP_DIR

清理临时目录（避免占磁盘）

rm -rf $TEMP_DIR

echo “打包完成！文件路径：$OUTPUT_DIR/myrepo_trunk_$DATE.tar.gz”

保存后，用chmod +x pack.sh赋予执行权限——这样运行./pack.sh，就能导出主干的最新版本，压缩成带日期的文件。如果你是Windows，把脚本改成bat格式就行，核心命令还是svn export和zip。
配置自动化：用钩子脚本实现“提交即打包”
如果想让“提交代码后自动打包”，就得用hooks/post-commit钩子脚本。进入仓库的hooks目录，把post-commit.sample改成post-commit，然后编辑内容： 

bash
#!/bin/sh

调用打包脚本（写绝对路径！）

/home/svn/scripts/pack.sh

保存后，同样用

chmod +x post-commit赋予执行权限——这样每次有人提交代码（svn commit），钩子脚本就会自动调用pack.sh，生成最新的打包文件。我之前在公司用这个配置，每次开发提交代码后，测试直接去/opt/package拿最新包，省了很多沟通成本。

按这些步骤试一遍，要是还遇到“导出失败”“打包文件不全”的问题，欢迎在评论区留消息，我帮你排查——毕竟这些坑我都踩过，比你更懂怎么绕开。

---

导出源码时提示“权限不足”，明明已经给目录加了权限，怎么办？

先检查authz文件里的权限配置有没有加“”号——SVN的权限默认不继承，父目录的权限不会自动传给子目录。比如你给/trunk加了dev组的rw权限，得写成“@dev = rw”（末尾加），这样子目录才会继承权限。另外要确认路径是仓库内的相对路径，比如“[myrepo:/trunk]”而不是本地磁盘路径（像/home/svn/repo/trunk这种写法是错的），SVN不认本地路径哦。

还有种情况是用户组的写法，要加@符号，比如“@dev”而不是“dev”，不然SVN识别不了这是个用户组，权限也不会生效。

打包后的文件里有.svn隐藏文件夹，怎么去掉？

因为你用了“svn checkout”命令！SVN的checkout是“检出”带版本信息的副本，会自动生成.svn文件夹存版本数据；要拿“干净源码”得用“svn export”命令——它会导出仓库里某个版本的无.svn文件夹的副本。比如脚本里写“svn export 仓库路径 临时目录 force”，就能避免冗余的.svn文件夹啦。

要是已经用了checkout，也不用重新来，直接删了.svn文件夹再压缩就行，但不如export一步到位省心。

配置了post-commit钩子，提交代码后没自动打包，哪里错了？

先查钩子脚本的“执行权限”——Linux下要给post-commit文件加x权限，用“chmod +x post-commit”，不然SVN调用不了脚本。然后看脚本里的路径是不是绝对路径，比如调用打包脚本的路径要写“/home/svn/scripts/pack.sh”，而不是“../scripts/pack.sh”，相对路径会导致SVN找不到脚本。

还有种情况是钩子脚本里的变量没定义对，比如REPO_URL是不是正确的仓库路径，TEMP_DIR有没有创建权限，比如/tmp目录一般都有权限，但要是自定义的目录，得确保svn用户（比如www-data或者root）能写。

打包的源码漏了子目录，是哪里没设置对？

首先看SVN权限有没有开“递归”——authz文件里的权限要加号，比如“@dev = rwx”，这样子目录才会继承父目录的权限，导出时才能访问到子目录。然后检查打包脚本里的REPO_URL是不是包含了子目录，比如要导出/trunk下的所有子目录，REPO_URL得写成“svn://localhost/myrepo/trunk”，而不是只写到/myrepo，不然导出的是仓库根目录，子目录可能没被包含。

svn export命令后面要加force参数，强制覆盖临时目录的旧文件，避免子目录因为之前的残留没被重新导出。

Windows下写打包脚本，svn export命令怎么用？

Windows的命令格式和Linux差不多，只是路径用反斜杠或者正斜杠都行，比如：“svn export username 张三 password 123456 svn://localhost/myrepo/trunk D:tempsvn_export force”——这里的force是强制覆盖已有的临时目录，避免导出失败。

压缩的话，Windows自带的zip命令可以用“zip -r D:packagemyrepo_trunk_20240520.tar.gz D:tempsvn_export”，或者用7-Zip的命令“7z a -tzip D:packagemyrepo_trunk_20240520.zip D:tempsvn_export”，注意路径要写绝对路径，不然压缩的文件会找不到。