Astro官方插件必须装，但仅安装无法启用功能；需配置astro.config.mjs/ts、.vscode/settings.json中"files.associations"绑定.astro为astro语言模式，并在tsconfig.json中添加"types": ["astro"]和"include"项，缺一不可。
Astro 官方插件必须装，但只装它，.astro 文件基本等于没配——高亮、补全、跳转、类型提示全会失效。
为什么装了 Astro 插件右下角还是显示 Plain Text
VSCode 不会自动把 .astro 后缀和 Astro 语言模式绑定，哪怕插件已安装。这是最常见、也最容易被忽略的启动障碍。
- 手动验证：打开任意
.astro文件，看右下角状态栏语言模式；若不是Astro，说明没接管 - 临时解决：按
Ctrl+K Ctrl+M（Win/Linux）或Cmd+K Cmd+M（Mac），输入Astro并选择 - 永久生效：在项目根目录的
.vscode/settings.json中加这一行："files.associations": {"*.astro": "astro"} - 若仍不出现
Astro选项，检查项目根目录是否存在astro.config.mjs或astro.config.ts——插件依赖该文件启动语言服务器
TS 提示 “Cannot find module ‘astro’” 怎么破
这不是代码写错了，是 VSCode 的 TypeScript 服务压根没加载 astro 类型定义。终端里 npm run dev 能跑，编辑器里照样报红。
- 确认本地已安装
astro（不是全局）：npm list astro或pnpm list astro - 确保
tsconfig.json包含这两项："types": ["astro"]和"include": ["src/**/*", "astro.config.*"] - 运行命令面板（
Ctrl+Shift+P）→Developer: Restart TS Server，强制重载类型系统 - 若用
pnpm，检查pnpm store是否被 VSCode 排除；可加配置："typescript.preferences.includePackageJsonAutoImports": "auto"
组件路径补全不提示？别怪插件，先查路径映射
.astro 文件里的组件导入路径补全，VSCode 默认不支持——它只对 .js/.ts 做深度扫描，.astro 需额外“喂”信息。
立即学习“前端免费学习笔记（深入）”；
- 确认
tsconfig.json或jsconfig.json中没有把src/**/*.{astro,mdx}写进"exclude" - 装
Path Intellisense插件，它会主动扫描src/下所有文件（包括.astro），补全才真正可用 - 若仍无提示，检查
"files.associations"是否已设为{"*.astro": "astro"}；未设则补全逻辑根本不会触发
astro check 报错但 VSCode 里不标红
Astro 官方插件默认只做语法解析，不做类型校验。所以 props 类型错、组件引用不存在这类问题，在编辑器里完全静默，直到你运行 astro check 或 npm run build 才暴露。
- 启用类型服务：在
.vscode/settings.json加"astro.trace.server": "verbose"，并确保已安装@astrojs/ts-plugin - 更稳方案：用
eslint-plugin-astro+ ESLint 插件，它能实时标出路径错误、未闭合标签、无效client:only等结构问题 - 注意：
astro check依赖tsconfig.json；JS 项目需配jsconfig.json，否则直接跳过检查
真正卡住人的从来不是插件装没装，而是 astro.config.* 存不存在、tsconfig.json 的 include 漏没漏 .astro、以及 VSCode 是否还在用内置 TS 服务——这三处一错，其余配置全白搭。
