PHP文件默认不关联编辑器,需手动绑定至VS Code等编辑器:Windows用右键“打开方式”设置,macOS通过“显示简介”修改,默认应用被重置时需检查系统设置。

PHP 文件默认不关联编辑器,双击直接运行会报错或空白——因为 PHP 是服务端脚本,不是可执行程序。必须手动把 .php 文件后缀绑定到你常用的代码编辑器(如 VS Code、PhpStorm、Sublime Text),才能双击即开。
Windows 上用右键菜单设置默认编辑器
这是最直观、最常用的方式,适合大多数本地开发场景:
- 右键任意
.php文件 → 选择 “打开方式” → “选择其他应用” - 勾选 “始终使用此应用打开 .php 文件”
- 点击
VS Code(或你已安装的编辑器);若没列出,点 “查找其他应用”,浏览到其安装路径(如C:\Users\XXX\AppData\Local\Programs\Microsoft VS Code\Code.exe) - 确认后,所有
.php文件双击都会用该编辑器打开
⚠️ 注意:如果编辑器是便携版(比如绿色解压版),它可能不会自动注册文件关联,需手动指定完整路径,且不能选错可执行文件(例如别选成 resources 目录下的某个子进程)。
macOS 上通过“显示简介”修改默认打开方式
macOS 不依赖注册表,靠系统级文件类型绑定:
立即学习“PHP免费学习笔记(深入)”;
- 右键一个
.php文件 → “显示简介” - 展开 “打开方式” 下拉菜单,选择你的编辑器(如
Visual Studio Code) - 点旁边的 “全部更改…” 按钮,确认将所有
.php文件都用该应用打开
✅ 成功后 Finder 中 .php 图标会变成编辑器图标。如果选项里没有目标编辑器,先用该编辑器打开一个文件,再回到“显示简介”重试——这能触发系统补全注册。
命令行快速修复(Linux / macOS / Windows WSL)
当图形界面设置失效,或你想批量处理时,用命令行更可靠:
- Linux(GNOME):
xdg-mime default code.desktop text/x-php(前提是已安装 VS Code 的 desktop 文件) - macOS:
defaults write com.apple.LaunchServices LSHandlers -array-add '{LSHandlerContentType=public.php-script;LSHandlerRoleAll=com.microsoft.VSCode;}',然后运行lsregister -f /Applications/Visual\ Studio\ Code.app - Windows(PowerShell):
cmd /c 'assoc .php=VisualStudioCode.phpfile' && cmd /c 'ftype VisualStudioCode.phpfile="C:\Users\XXX\AppData\Local\Programs\Microsoft VS Code\Code.exe" "%1"'
⚠️ 这些命令对路径和 MIME 类型敏感,code.desktop 或 com.microsoft.VSCode 写错一个字符就会失败,建议先查清编辑器实际注册名(Linux 用 xdg-mime query default text/x-php,macOS 用 defaults read com.apple.LaunchServices LSHandlers | grep php)。
真正容易被忽略的是:有些编辑器(比如旧版 Sublime Text)安装时默认不注册 .php 关联,只注册了 .html 或 .js;还有些杀毒软件或系统优化工具会悄悄重置文件关联——所以如果某天双击又打不开,先检查“默认应用设置”里 .php 是否仍指向你想要的程序。











