Deployment path映射服务器上文件实际存储的绝对路径，Web path映射浏览器访问时URL的前缀（相对路径，必须以/开头且与DocumentRoot子路径严格一致）。
Deployment → Mappings 里的 “Deployment path” 和 “Web path” 到底映射谁？
很多人把这两个字段当成一回事，结果上传成功但浏览器打不开，或者断点不触发。关键区别在于：Deployment path 是文件实际存到服务器哪个目录（绝对路径），而 Web path 是你通过浏览器访问时 URL 的前缀（相对路径，必须以 / 开头）。
比如你在 SFTP 配置里填了 Root path 为 /var/www/html/myapp，那 Deployment path 就该填 /myapp 或 /（取决于你想映射整个目录还是子目录）；而 Web path 必须和 Web 服务器的 DocumentRoot 下的子路径严格一致——如果 Apache 的 DocumentRoot 是 /var/www/html，项目放在 /var/www/html/myapp，这里就必须填 /myapp，填 / 或 /myapp/（多斜杠）都会导致 $_SERVER['REQUEST_URI'] 错乱、重写规则失效。
-
Deployment path错了 → 文件传到错位置，ls -l /var/www/html看不到你的文件 -
Web path错了 → 浏览器访问http://localhost/myapp/index.php报 404，但文件明明在服务器上 - 两者都对，但没勾选
Use path mappings→ PhpStorm 根本不读这个 tab 的配置，上传行为退化为“按项目根名硬猜”
怎么让同一个项目在测试机、预发机、生产机用不同上传路径？
PhpStorm 不支持“环境变量式”的动态路径替换，但可以用「服务器配置隔离 + 项目级切换」实现。核心是：每个远程目标单独建一个服务器条目，名字带环境标识（如 staging-sftp、prod-sftp），然后靠手动或快捷键切换当前激活的部署目标。
操作要点：
立即学习“PHP免费学习笔记（深入）”；
- 进
File → Settings → Build, Execution, Deployment → Deployment，点+新建多个服务器，协议、主机、认证方式各自填对 - 每个服务器的
Mappingstab 单独配：测试机的Deployment path可能是/var/www/test/myproject，生产机则是/var/www/live/myproject - 上传时右键文件 →
Deployment → Upload to …，菜单里会列出所有已配置的服务器，选对应环境即可 - 想默认上传到某个环境？在
Deployment主页选中它，勾上Default server—— 但注意：这不会自动帮你切 PHP 解释器或 Xdebug 配置，那些还得另外配
为什么改了 Mappings 却不生效？常见三类静默失败
不是所有修改都会立刻反映在上传行为上，尤其当你混用了本地挂载、SFTP、自动同步等模式时。
-
本地挂载路径被系统缓存：选了
Local or mounted folder类型后，如果挂载点（比如/mnt/remote）在系统里被 umount 过又重挂，PhpStorm 可能还记着旧 inode，上传时提示“权限拒绝”但不报具体路径。解决方法：删掉该服务器配置，重新添加，且确保挂载命令里加了-o cache=none（Linux/macOS） -
自动上传模式冲突：如果同时开了
Upload external changes和On explicit save，编辑器可能在你 Ctrl+S 后立即上传，但此时文件还没写完（尤其大文件），导致远程端拿到的是截断内容。建议只留一个，优先选On explicit save -
路径含中文或空格未转义：Windows 下若
Deployment path是D:我的项目src，某些 FTP 插件会把我的解析成乱码。统一用英文路径，或改用 UNC 路径\localhostc$myprojectsrc
PHP Servers 里的 Web path 和 Deployment 的 Web path 冲突吗？
完全不冲突，因为它们压根不是一回事，服务对象也不同。
Settings → Languages & Frameworks → PHP → Servers 里的 Web path 是给 Xdebug 和 Open in Browser 用的：它告诉 PhpStorm，“我本地的 index.php，对应浏览器里 http://localhost/myproject/index.php 的哪个部分”。而 Deployment → Mappings 里的 Web path on server 是给上传逻辑和 URL 构造用的，影响的是“上传后生成的预览链接长什么样”。两个字段可以相同（常见于单环境开发），也可以不同（比如调试用 /dev，上线用 /）。
最容易踩的坑是：Xdebug 断点不触发，查日志发现 Cannot resolve path 'C:projectindex.php' on server —— 这说明 PHP Servers 里的 Web path 没配，或配错了，跟 Deployment 无关。这时候去 Deployment 里调路径，纯属白忙。
