首次搭建Astro项目运行npm run dev报错：找不到fast-glob模块

问题描述 #

首次搭建Astro项目，按官方文档执行npm create astro@latest创建项目并完成npm install，运行npm run dev启动服务器时出现错误：Loading PostCSS Plugin failed: Cannot find module 'fast-glob'。未手动使用或配置Tailwind CSS，全新项目却出现相关错误。

完整错误日志：

01:16:23 pm [astro] Unable to load C:\Users\folder-path...\dangerous-disk\astro.config.mjs
error Loading PostCSS Plugin failed: Cannot find module 'fast-glob'
Require stack:

• C:\Users\sahilp\Desktop\project\node_modules\tailwindcss\lib\lib\setupTrackingContext.js
• C:\Users\sahilp\Desktop\project\node_modules\tailwindcss\lib\index.js
• C:\Users\sahilp\Desktop\project\postcss.config.js
  (@C:\Users\sahilp\Desktop\project\postcss.config.js)
  Error: Loading PostCSS Plugin failed: Cannot find module 'fast-glob'
• C:\Users\sahilp\Desktop\project\node_modules\tailwindcss\lib\lib\setupTrackingContext.js
• C:\Users\sahilp\Desktop\project\node_modules\tailwindcss\lib\index.js
• C:\Users\sahilp\Desktop\project\postcss.config.js
  (@C:\Users\sahilp\Desktop\project\postcss.config.js)
  at load (C:\Users\folder-path...\dangerous-disk\node_modules\postcss-load-config\src\plugins.js:28:11)
  at C:\Users\folder-path...\dangerous-disk\node_modules\postcss-load-config\src\plugins.js:53:16

原因分析 #

错误日志显示项目根目录存在postcss.config.js文件，且该文件引入了Tailwind CSS插件。可能是创建项目时误选了包含Tailwind的模板，或是npm安装过程中依赖被意外引入，导致PostCSS尝试加载Tailwind，但Tailwind的依赖fast-glob未正确安装。

修复步骤 #

• 移除不必要的PostCSS配置：查看项目根目录的postcss.config.js，若你不需要Tailwind，直接删除该文件，或注释掉文件内Tailwind插件的引入代码。
• 安装缺失依赖（如需保留Tailwind）：若后续要使用Tailwind，执行命令安装缺失的依赖：

  npm install fast-glob --save-dev
  

• 重新安装依赖：删除node_modules文件夹和package-lock.json，再执行npm install重新安装所有依赖，确保依赖完整。
• 重建纯净项目：若以上方法无效，重新执行npm create astro@latest，创建时选择不含Tailwind的基础模板，避免自动引入不必要的依赖。

内容的提问来源于stack exchange，提问作者Mohammad Farhan