新建PHP项目需先选对项目类型和配置正确PHP解释器，否则调试、补全、Composer均异常；项目路径须纯英文无空格，且需提前验证php/composer命令可用。
PhpStorm 新建项目不是点“新建”就完事——关键在选对项目类型和解释器，否则后续调试、自动补全、Composer 支持都会出问题。
选错 Project type 会导致代码不识别或无法运行
新建项目时，PhpStorm 会弹出 Create New Project 对话框，顶部的下拉菜单决定底层行为：
-
PHP：适合纯 PHP 项目（如自写脚本、小型 API），默认不带框架结构 -
Laravel/Symfony/WordPress：选择后会自动调用对应 CLI 工具（如laravel new）初始化，同时配置好路径映射和框架专属支持 -
Empty Project：仅建空目录，不生成任何文件，适合已有代码直接导入，但不会自动配 PHP 解释器
如果选了 PHP 却想跑 Laravel，后续要手动改 composer.json、配 autoload、设 public/ 为根路径——补救成本远高于一开始选对。
PHP 解释器没配或配错，var_dump() 能运行但断点不生效
即使项目建好了，没有正确关联本地 PHP 可执行文件（即解释器），PhpStorm 就无法做语法检查、无法跳转函数定义、Xdebug 断点也不会触发。
立即学习“PHP免费学习笔记（深入）”；
- Windows 常见错误路径：
C:/php/php.exe（注意不是php-win.exe） - macOS/Homebrew 用户应选
/opt/homebrew/bin/php或/usr/local/bin/php，别选系统自带的/usr/bin/php（版本太旧且无扩展） - Docker 用户不要选宿主机上的
php，而应在Settings > PHP > Interpreter > Add > Docker中配置容器内解释器
验证是否成功：建一个 test.php，写 ，右键 Run —— 如果输出版本号且底部状态栏显示 PHP Interpreter: ...，才算到位。
项目路径含中文或空格，Composer install 会失败或提示 invalid argument
PhpStorm 不阻止你把项目建在 D:/我的项目/blog 或 /Users/xxx/Php Projects/blog，但 Composer 和多数 PHP 扩展在解析路径时会因编码或 shell 转义异常中断。
- 推荐路径全部使用英文小写 + 下划线，例如：
/home/user/php_projects/my_blog - Windows 用户尤其注意：避免路径含
Program Files、AppData等受权限限制的目录 - 新建项目前先在终端确认：
which php和composer --version都能正常返回，再进 PhpStorm 创建
composer create-project laravel/laravel my_app # ✅ 正确：路径干净，无空格无中文 # ❌ 错误示例（后续报错率高）： # composer create-project laravel/laravel "My Blog"
真正卡住新手的，往往不是按钮在哪，而是解释器路径多了一个反斜杠、项目名用了破折号、或者以为“新建项目=新建文件夹”，结果漏掉了 Composer 初始化这步。这些细节一旦错，后面每一步都在修基建。