VSCode右下角显示Plain Text而非Astro，需手动绑定语言模式或配置"files.associations": {"*.astro": "astro"}；TypeScript报错需确认本地安装astro、tsconfig.json含"types": ["astro"]并重启TS Server；路径补全依赖Path Intellisense插件；类型检查需启用@astrojs/ts-plugin或eslint-plugin-astro。
VSCode右下角显示Plain Text而不是Astro？立刻修复语言模式绑定
装完Astro官方插件后仍无高亮、无补全，90%是因为.astro文件没被识别为Astro语言——VSCode默认不自动关联。必须手动或配置强制绑定。
- 临时解决：打开任意
.astro文件 → 点击右下角语言标识（如显示Plain Text）→ 输入Astro并选择它 - 永久生效：在项目根目录的
.vscode/settings.json中添加"files.associations": {"*.astro": "astro"} - 若选不到
Astro选项，检查是否安装了旧版astro-vscode（v1.x），必须卸载并换用官方新插件（作者是astro）
TypeScript报“Cannot find module ‘astro’”？不是代码错，是TS服务没加载类型
终端里npm run dev能跑通，但VSCode里TS提示一堆红线，典型症状是import type { Props } from 'astro'爆红——这和运行时无关，纯属编辑器类型系统未就位。
- 先确认项目本地已装
astro包：npm list astro（不能只靠全局安装） - 确保
tsconfig.json含"types": ["astro"]，且"include"包含src/**/*和astro.config.* - 执行VSCode命令面板里的
Developer: Restart TS Server，强制重载类型服务 - 若用
pnpm，检查pnpm store路径是否被VSCode排除；可加配置"typescript.preferences.includePackageJsonAutoImports": "auto"
组件路径补全失效？Path Intellisense才是关键补全引擎
Astro插件本身不负责路径补全，它只管语法和类型。当你输入import Header from '../却没提示components/Header.astro，问题不在Astro插件，而在路径扫描能力缺失。
- 必须安装
Path Intellisense插件——它会主动索引src/下所有文件，包括.astro和.md - 确认
tsconfig.json或jsconfig.json中没把src/**/*.{astro,mdx}写进"exclude" - 若仍不提示，检查
files.associations是否已配好，否则Path Intellisense压根不知道该扫描哪些文件
astro check不报错但VSCode里没红线？类型检查需额外启用
astro check命令能发现props类型不匹配、导入路径错误等问题，但Astro插件默认只做基础语法校验，不会触发这套类型检查链。
- 启用
@astrojs/ts-plugin：在.vscode/settings.json中加"astro.trace.server": "verbose"，并确保项目已安装该插件 - 更实用方案：用
eslint-plugin-astro配合ESLint插件，它能在编辑时实时标出组件结构、属性拼写、路径有效性等问题 - 注意：
astro check依赖tsconfig.json；JS项目必须配jsconfig.json，否则直接跳过检查
真正卡住人的从来不是插件装没装，而是语言模式、类型服务、路径扫描、检查插件这四层是否全部对齐。少一层，VSCode就退回“看着像Astro，实际当HTML用”的状态。
