VS Code 本身不提供“创建 PHP 项目”的向导式菜单,它只是一个代码编辑器,没有内置的项目初始化逻辑。真正创建 PHP 项目,靠的是你在终端里执行命令(比如 composer create-project 或 mkdir + touch),然后用 VS Code 打开那个文件夹——这个文件夹就是你的项目。怎么让 VS Code 正确识别并支持 PHP光有文件夹不行,VS Code 需要装扩展、配好环境,才能语法高亮、跳转、调试:必须安装官方推荐的 PHP Intelephense(功能最全)或 PHP Tools(商业但体验好),PHP Debug(Xdebug/Laravel Valet 必装)确保系统已安装 PHP CLI:在终端运行 php -v 能输出版本号;如果报 command not found,需先配置系统 PATH 或用 Homebrew(macOS)、apt(Ubuntu)、winget(Windows)安装 PHPVS Code 设置中确认 "php.suggest.basic": false(关掉默认提示,避免和 Intelephense 冲突)从零初始化一个标准 PHP 项目(推荐 Composer 方式)手动建 index.php 只能算“写 PHP 文件”,不是“搭项目”。现代 PHP 项目依赖管理、自动加载、开发服务器都靠 Composer。mkdir my-php-appcd my-php-appcomposer init --no-interaction --name="myvendor/myapp" --type="project"

VS Code 本身不提供“创建 PHP 项目”的向导式菜单,它只是一个代码编辑器,没有内置的项目初始化逻辑。真正创建 PHP 项目,靠的是你在终端里执行命令(比如 composer create-project 或 mkdir + touch),然后用 VS Code 打开那个文件夹——这个文件夹就是你的项目。
怎么让 VS Code 正确识别并支持 PHP
光有文件夹不行,VS Code 需要装扩展、配好环境,才能语法高亮、跳转、调试:
- 必须安装官方推荐的
PHP Intelephense(功能最全)或PHP Tools(商业但体验好),PHP Debug(Xdebug/Laravel Valet 必装) - 确保系统已安装 PHP CLI:在终端运行
php -v能输出版本号;如果报command not found,需先配置系统 PATH 或用 Homebrew(macOS)、apt(Ubuntu)、winget(Windows)安装 PHP - VS Code 设置中确认
"php.suggest.basic": false(关掉默认提示,避免和 Intelephense 冲突)
从零初始化一个标准 PHP 项目(推荐 Composer 方式)
手动建 index.php 只能算“写 PHP 文件”,不是“搭项目”。现代 PHP 项目依赖管理、自动加载、开发服务器都靠 Composer。
mkdir my-php-app cd my-php-app composer init --no-interaction --name="myvendor/myapp" --type="project" composer require monolog/monolog ^3.0
这会生成 composer.json、composer.lock 和 vendor/ 目录。之后在 VS Code 中用 File → Open Folder… 选中 my-php-app 即可。
立即学习“PHP免费学习笔记(深入)”;
-
composer init的--no-interaction避免交互提问,适合快速启动 - 别跳过
composer install(或上面的require),否则vendor/autoload.php不存在,require_once会失败 - 如果只是练手小脚本,不用 Composer?那就建空文件夹 → 新建
index.php→ 写→ 用 PHP 内置服务器跑:php -S localhost:8000
为什么刚打开项目没智能提示或报错红线?
常见原因不是插件没装,而是路径或配置没对上:
- 检查 VS Code 左下角状态栏是否显示 PHP 版本(如
PHP 8.2),没显示说明没找到 PHP 可执行文件 → 在设置里搜php.executablePath,填绝对路径,例如/usr/bin/php或C:\php\php.exe - Intelephense 默认只扫描当前打开的文件夹及其子目录;如果你打开的是父级目录(比如桌面上的
projects/),它不会自动识别里面的my-php-app/为独立项目 → 务必直接打开项目根文件夹 - 首次打开可能需要几秒索引
vendor/,右下角有 “Indexing…” 提示,等它消失再看提示是否恢复
最关键的一步永远不是点哪个菜单,而是确认 PHP CLI 可达、Composer 可运行、VS Code 打开的是正确的根目录——这三个条件缺一不可。其他所有功能(格式化、调试、自动补全)都是在这基础上叠加上去的。











