svn的环境变量

装完SVN客户端，环境命令行敲svn却提示“不是变量内部或外部命令”——这事我遇到过不下十次，每次都是环境在Windows上。原因就一个：SVN的变量安装目录没进PATH。 TortoiseSVN默认只装图形界面，环境命令行工具要手动勾选，变量勾了也不一定自动配环境变量。环境很多人卡在这一步，变量以为装失败了，环境其实只是变量系统找不到svn.exe在哪。

环境变量说白了就是环境告诉操作系统：去哪些文件夹里找可执行程序。Windows下分用户变量和系统变量，变量用户变量只对当前登录账号生效，环境系统变量对所有用户生效。变量SVN一般配系统变量，环境因为服务器上可能多个账号都要用。Linux和macOS下是PATH变量，改法不同，逻辑一样。

具体路径长什么样？Windows上TortoiseSVN的命令行工具通常在C:\Program Files\TortoiseSVN\bin。注意这个bin目录，不是安装根目录。我第一次配的时候把根目录塞进PATH，结果还是找不到，折腾了二十分钟才发现少了一层。VisualSVN Server自带命令行工具的话，路径又不一样，一般是C:\Program Files\VisualSVN Server\bin。两个都装了就都加上，不冲突。

改PATH有个坑：Windows的编辑框里是一长串分号分隔的路径，新增的条目要放在合适位置。放末尾最安全，但如果你机器上同时有多个SVN版本，放前面那个会优先被找到。我见过有人PATH里既有1.8又有1.14，命令行调出来的是老的，提交时各种报错，查了半天版本才发现问题。用svn --version确认当前生效的是哪个，这步别省。

Linux下配SVN环境变量更直接。打开~/.bashrc或/etc/profile，加一行export PATH=$PATH:/opt/svn/bin，然后source一下。但要注意，如果你用sudo执行svn命令，它读的是root的PATH，不是当前用户的。这个细节坑过不少人——普通用户下svn能用，一加sudo就找不到命令。解决办法是在/etc/sudoers里保留PATH，或者干脆用绝对路径。

还有一个容易被忽略的点：环境变量改了之后，已经打开的终端或命令行窗口不会自动刷新。Windows的cmd要关掉重开，PowerShell也是。Linux的终端同样，source只对当前会话生效，新开的窗口读的是配置文件的最新值。我习惯改完直接开个新窗口验证，省得在旧窗口里反复试。

macOS从Catalina开始默认shell换成了zsh，配置文件是~/.zshrc而不是~/.bash_profile。很多人照着老教程改bash的配置，改完没反应，就是因为shell换了。用echo $SHELL确认一下当前用的是哪个，再决定改哪个文件。Homebrew装的SVN通常在/usr/local/bin或/opt/homebrew/bin，这两个路径一般已经在PATH里了，但Apple Silicon的机器上/opt/homebrew/bin需要手动加，Homebrew安装完会提示你。

配完环境变量，svn --version --quiet能输出版本号就算成了。别小看这一行输出，它意味着后面所有的svn checkout、svn commit、svn update才能正常跑。环境变量这东西，配一次管很久，但第一次配的时候多花五分钟确认清楚，比后面遇到问题再回头查要划算得多。