Astro插件未生效主因是文件关联错误或缺少astro.config.mjs/ts配置文件，需安装官方Astro插件、手动设置语言模式为Astro、确保配置文件存在并重启TS服务器。
Astro插件没生效，astro 文件还是灰乎乎的？
VSCode 默认不识别 .astro 文件，装了插件却没高亮、没补全，大概率是插件没启用或文件关联错了。Astro 官方推荐的插件是 Astro（由 the Astro team 维护），不是名字相近的 astro-vscode 或其他旧版。
- 在扩展市场搜
Astro，认准发布者是Astro（带官方徽章），安装后重启 VSCode - 检查当前文件是否被识别为 Astro：右下角状态栏点击语言模式（如“Plain Text”），手动选
Astro；也可用快捷键Ctrl+K Ctrl+M（Win/Linux）或Cmd+K Cmd+M（Mac）调出语言切换面板 - 如果仍无效，确认工作区根目录有
astro.config.mjs或astro.config.ts—— 插件依赖该配置文件激活语言服务器
astro check 报错“Cannot find module ‘astro’”，但项目能跑？
这是 VSCode 的 TypeScript 语言服务没正确加载 Astro 类型定义导致的，和终端里 npm run dev 能运行不冲突。本质是编辑器没读到 node_modules/astro 里的类型声明。
- 确保项目已安装
astro（npm install astro或pnpm add astro），且不是全局安装 - 在 VSCode 中打开命令面板（
Ctrl+Shift+P），运行Developer: Restart TS Server，强制重载类型系统 - 如果用 pnpm，还需检查
pnpm store是否被 VSCode 排除；可在.vscode/settings.json加："typescript.preferences.includePackageJsonAutoImports": "auto"
IntelliSense 提示不全，import 组件时没路径自动补全
Astro 的组件导入路径是相对的，但 VSCode 默认只对 .js/.ts 做路径智能提示，对 .astro 文件需额外配置路径映射或启用实验性支持。
- 在
tsconfig.json或jsconfig.json中确保包含"include": ["src/**/*"]，且没有把src/**/*.{astro,mdx}排除在外 - 添加
"compilerOptions": { "types": ["astro"] }显式引入 Astro 类型 - 组件路径补全依赖 VSCode 的
Path Intellisense插件（非必须，但推荐）—— 安装后它会扫描src/下所有文件，包括.astro
保存时格式化失效，prettier 不处理 .astro 文件
Prettier 默认不支持 .astro，必须显式告诉它：这个文件类型要走 HTML + TypeScript 混合解析器。
- 在
.prettierrc或prettier.config.js中加："overrides": [{ "files": "*.astro", "options": { "parser": "astro" } }] - 确保已安装
@prettier/plugin-astro（npm install -D @prettier/plugin-astro），否则parser: "astro"会报错 - VSCode 设置里确认
"editor.formatOnSave": true，且默认格式化工具设为 Prettier（不是 ESLint 或内置 HTML 格式化）
最常被忽略的是语言服务器启动时机：Astro 插件需要先找到 astro.config.* 才加载完整功能，所以空项目或配置放错位置时，高亮、跳转、类型检查都会断掉。别急着换插件，先盯住右下角那个语言模式和配置文件是否存在。
