要用好 PhpStorm 的 SVN，必须指定真实 svn.exe 路径、正确设置 svn:keywords 和 svn:externals 属性、及时刷新状态，并手动触发认证；否则将频繁出现执行失败、状态不同步、属性不生效等问题。
PhpStorm 要真正用好 SVN，关键不是“能连上”，而是让 IDE 和 SVN 客户端行为一致、状态同步、权限可控。否则你会反复遇到 Executable is not specified、文件状态不刷新、提交失败却无提示、属性丢失等问题。
为什么必须指定 svn.exe 而不能只靠插件？
PhpStorm 的 Subversion 插件本身不带命令行能力，它只是 UI 层；所有实际操作（svn checkout、svn commit、svn propset）都依赖外部 svn.exe（Windows）或 svn（macOS/Linux）。如果没配，IDE 就像有遥控器但没接电源——菜单能点，一执行就报错。
-
File → Settings → Version Control → Subversion → General中勾选Use command line client - 点击右侧
...按钮，**必须指向真实可执行文件**：Windows 是svn.exe（常见路径如C:\Program Files\VisualSVN Server\bin\svn.exe或C:\Users\XXX\scoop\apps\svn\current\bin\svn.exe），macOS 是/usr/local/bin/svn或brew --prefix subversion返回路径下的bin/svn - 别用“系统默认”或留空——PhpStorm 不会自动找，也不会 fallback 到内置模拟器
svn:externals 和 svn:keywords 属性在 PhpStorm 里怎么设才生效？
这类属性直接影响文件内容（比如 $Id$ 自动展开）或检出结构（比如 svn:externals 引入第三方库），但 PhpStorm 的图形界面容易漏掉关键细节。
- 右键文件/目录 →
Subversion → Edit Properties打开SVN Properties视图 - 添加
svn:keywords时，**必须手动输入值**（如Id Date Revision），不能只勾选关键字——勾选只是辅助填值，最终要落进文本框 - 设置
svn:externals时，**每行格式必须严格为：目录名 URL或-r N 目录名 URL**，中间是空格，不是 Tab；URL 必须可访问，且需提前认证（PhpStorm 不会为你弹窗输密码） - 勾选
Recursive update property才能让子目录继承，否则只作用于当前项
提交时文件状态显示 “ignored” 或 “unversioned”，但实际已 svn add 过？
这是 PhpStorm 缓存和 SVN 工作副本元数据不同步的典型表现，尤其发生在命令行操作后切回 IDE，或跨平台共享工作副本时。
立即学习“PHP免费学习笔记（深入）”；
- 先执行
svn status在终端确认真实状态：如果输出中有A（added）但 PhpStorm 显示灰色“unversioned”，说明 IDE 元数据没刷新 - 不要直接点
VCS → Git → Add（那是 Git 的）——正确做法是右键文件 →Subversion → Add to VCS，或按Ctrl+Alt+A - 若仍不识别，点击
Version Control工具窗口（Alt+9）右上角的Refresh图标（两个循环箭头），或执行VCS → Subversion → Update Project强制重载 - 极端情况可删掉项目根目录下的
.idea/vcs.xml和.idea/shelf/，重启 PhpStorm 重建 VCS 映射
最常被忽略的一点：SVN 的 auth 缓存由客户端管理，不是 PhpStorm。如果你在终端用 svn co 输过密码，PhpStorm 就能复用；但如果清过系统凭据或换了用户，IDE 可能卡在“等待认证”却无提示——此时要主动在终端执行一次 svn info 触发登录，再回 IDE 操作。
