VSCode中.astro文件无高亮、补全失效，根本原因是语言模式未绑定且类型系统未加载：需手动将右下角语言模式设为Astro，配置"files.associations": {"*.astro": "astro"}，并确保存在astro.config.mjs/ts、tsconfig.json含"types": ["astro"]及"include"项，同时安装@prettier/plugin-astro并重启TS服务器。
VSCode 里 .astro 文件没高亮、补全失效、跳转点不动——不是插件没装，是语言模式根本没绑定，类型系统压根没加载 Astro 的定义。
为什么 .astro 文件右下角显示 “Plain Text”
VSCode 默认不认识 .astro 后缀，官方 Astro 插件不会自动接管文件。即使插件已安装，只要状态栏没显示 Astro，后续所有功能（高亮、补全、跳转）都形同虚设。
- 临时解决：打开任意
.astro文件 → 点击右下角语言标识 → 输入Astro并选中（注意大小写） - 永久解决：在项目根目录的
.vscode/settings.json中加这一行："files.associations": {"*.astro": "astro"} - 若选不了
Astro，检查项目根目录是否存在astro.config.mjs或astro.config.ts—— 缺这个文件，Astro 插件的语言服务器压根不启动
TS 类型提示报 “Cannot find module ‘astro’”
这不是项目跑不起来，是 VSCode 的 TypeScript 服务没读到 astro 包里的类型声明。终端里 npm run dev 能跑，编辑器里照样一片红或没提示。
- 确认本地已安装：
npm list astro（不是全局安装，必须是项目级node_modules/astro） -
tsconfig.json必须包含："types": ["astro"]，且"include"至少含"src/**/*"和"astro.config.*" - 执行命令面板（
Ctrl+Shift+P）→ 运行Developer: Restart TS Server - 如果用
pnpm，额外加配置："typescript.preferences.includePackageJsonAutoImports": "auto"
Prettier 格式化 .astro 文件失败
prettier 默认完全不认识 .astro，不满足三个硬条件，保存时只会格式化 <script> 里的 JS/TS，HTML 结构和 frontmatter 原封不动。
PigX UI 前端开发
下载
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
立即学习“前端免费学习笔记（深入）”；
- 安装插件：
npm install -D @prettier/plugin-astro（@astrojs/prettier-plugin-astro已废弃） - 在
prettier.config.js或.prettierrc中加："overrides": [{"files": "*.astro", "options": {"parser": "astro"}}] - VSCode 设置中启用：
"editor.formatOnSave": true，并确认默认 formatter 是 Prettier（不是 ESLint 或其他）
组件路径补全还是不提示
VSCode 默认只扫描 .js/.ts 文件做路径补全，.astro 文件要靠额外机制识别。这不是插件 bug，是路径发现链断了。
- 确保
tsconfig.json或jsconfig.json中没有把src/**/*.{astro,mdx}写进"exclude" - 推荐装
Path Intellisense插件——它会主动扫描src/下所有后缀，包括.astro - 检查
.vscode/settings.json是否有误配："files.associations"里不能漏掉"*.astro": "astro"
最常被忽略的一环是 astro.config.mjs 文件的存在性——它不只是构建用的配置，更是整个 VSCode Astro 语言服务的启动开关。没它，其他所有配置都只是摆设。
