Astro VS Code 扩展详解.astro语言支持、配置项与常见问题排查【免费下载链接】astroThe web framework for content-driven websites. ⭐️ Star to support our work!项目地址: https://gitcode.com/GitHub_Trending/as/astro本文围绕 packages/language-tools/vscode/README.md 展开结合当前仓库源码语言服务、TypeScript 插件、语法定义与测试用例深入讲解 Astro 官方 VS Code 扩展的能力边界、配置方式与排错方法。读完你将掌握如何配置该扩展、各配置项的精确作用域与默认值、Inlay Hints 为何不生效以及如何修复并理解其底层由语言服务器 TypeScript 插件共同驱动的架构。Astro 的官方 VS Code 扩展发布名Astro包名astro-vscode位于 packages/language-tools/vscode为.astro文件提供完整的语言支持语法与语义高亮、诊断信息、智能补全、格式化、符号导航、悬停信息、跳转定义、Inlay Hints、代码折叠、代码片段与文件模板等。所有语言能力并非在扩展内部自研而是由 Astro 语言服务器astrojs/language-server位于 packages/language-tools/language-server 提供扩展本身只负责启动语言服务器并桥接 VS Code 与它之间的通信。此外扩展还内置打包了一个 TypeScript 插件让.ts/.js文件同样可以识别并正确处理.astro组件的导入与导出。一、扩展整体架构语言服务器 TypeScript 插件从 vscode/package.json 的依赖与入口可以看出该扩展的分层结构main指向./dist/node/client.js即 LSPLanguage Server Protocol客户端入口实际语言能力来自astrojs/language-server见 packages/language-tools/language-server通过contributes.typescriptServerPlugins注册名为astro-ts-plugin-bundle的 TypeScript 服务端插件开启enableForWorkspaceTypeScriptVersions对应独立发包 astrojs/ts-plugin源码在 packages/language-tools/ts-plugin扩展同时声明了astrojs/compiler、prettier与prettier-plugin-astro作为运行时依赖——这正是格式化由 Prettier prettier-plugin-astro 驱动这一结论的直接依据。客户端启动逻辑在 vscode/src/client.ts 中有完整呈现扩展读取astro.language-server配置段来确定语言服务器路径与运行时随后创建LanguageClient并通过 IPC 传输启动服务器。其中两个值得注意的细节自定义语言服务器路径client.ts中的getConfiguredServerPath()会依次检查全局/默认值以及工作区各层级的ls-path配置若工作区内存在自定义语言服务器路径首次打开时还会弹窗询问用户是否使用工作区内的语言服务器版本可选择Allow、Dismiss或Never in This Workspace。Content IntelliSense 开关驱动文档选择器当astro.content-intellisense开启时语言客户端才会把markdown、mdx、markdoc文档也纳入服务范围用于内容集合的类型补全。正是这种薄客户端 语言服务器 TS 插件的架构使得 VS Code、编辑器通过通用 LSP与纯 TypeScript 工程能共享同一套 Astro 语言智能。二、功能总览README 中列出的功能覆盖了一个现代编辑器语言支持应有的全部维度可以整理为下表以便速查能力类别说明语法与语义高亮基于 TextMate 语法syntaxes 目录下的 tmLanguage 文件 TypeScript 语义级高亮诊断信息错误与警告Diagnostics由语言服务器在编辑时实时上报IntelliSense 补全支持自动导入auto-imports的补全Emmet 补全在 HTML 与 CSS 上下文内生效组件 Props 补全对 JSX/TSX、Vue仅 Composition API与 Svelte 组件的 Props 提供补全Code Actions快速修复、排序导入等格式化由 Prettier 与 prettier-plugin-astro 驱动符号与导航大纲视图、面包屑、Go to Symbol、悬停信息、Go to Definition / Type Definition / ImplementationInlay Hints由 TypeScript 提供详见下文常见问题代码折叠配合语言配置中的折叠标记片段与文件模板随扩展内置的page_html、page_layout、component模板2.1 语法与语义高亮.astro文件的语法定义位于 vscode/syntaxes 目录包含三套 TextMate 语法astro.tmLanguage.json源定义是astro.tmLanguage.src.yaml核心语法负责source.astro作用域markdown.astro.tmLanguage.json注入到text.html.markdown与source.astro用于在 Markdown/.astro内嵌块中正确着色mdx.astro.tmLanguage.json注入到source.mdx处理 MDX 中内嵌的 Astro 代码块。package.json的contributes.grammars中通过embeddedLanguages声明了丰富的内嵌语言映射包括 HTML、Markdown、CSS含 Less/SCSS/Sass/Stylus、JavaScript、TypeScript、TSX、JSON 等这是.astro单文件里混写模板、script与style仍能获得正确高亮的原因。扩展仓库还配套了一套语法快照测试见 vscode/test/grammarfixtures 覆盖了组件、script事件/表达式/多行 TS、style的 Less/Sass/SCSS/Stylus/property等大量边界场景每个.astro用例都有对应的.snap快照用于防止语法高亮回归。2.2 格式化格式化能力由扩展内置的 Prettier 与 prettier-plugin-astro 提供见package.json的dependencies。因此 Prettier 的各种配置方式配置文件、editorconfig、VS Code settings 等对该扩展同样生效你可以把.prettierrc、prettier.config.js或astro专属格式化选项放入项目根目录来统一团队格式。2.3 组件 Props 补全与其他框架协同在.astro模板中 import React、Vue、Svelte 组件后编辑器会基于组件自身的 Props 类型推导补全。README 特别说明Vue 仅支持 Composition API 下的补全。此外扩展为 JSX/TSX、Vue、Svelte 组件提供统一的 Props 补全体验这是语言服务器与对应框架的语言能力协同工作的结果。2.4 代码片段与文件模板扩展内置了三个以.astro文件为作用域的文件模板定义在 languages/astro.code-snippetspage_html生成带完整html骨架的页面page_layout生成引用某个Layout组件的页面component生成最基础的组件骨架空 frontmatter 模板。在资源管理器 / 编辑器内新建.astro文件时即可从这些模板起步快速创建页面或组件。2.5 编辑体验细节vscode/languages/astro-language-configuration.json 定义了该语言的编辑器级行为包括括号自动配对含{/* */}、!-- --、/** */、注释块!-- --、折叠标记!-- #region --以及基于正则的智能缩进规则。package.json中还注册了breakpoints语言级断点与自动补全等能力方便在语言服务器内部进行调试。三、安装与激活条件扩展本身可通过 VS Code 扩展市场安装搜索Astro发布方为astro-build。从 vscode/package.json 可确认几个与安装运行相关的关键约束VS Code 版本要求engines.vscode为^1.101.0即需要 VS Code 2025 年 5 月版本1.101.0及以上CHANGELOG 中记录了该最低版本要求的上调激活时机activationEvents仅包含workspaceContains:astro.config.*——当你打开的工作区中出现astro.config.mjs、astro.config.ts等配置文件时扩展才会激活这保证了它不会在无关工作区中空转自动附带 TS 插件如前所述扩展通过typescriptServerPlugins自动配置 TS 插件因此使用本扩展时无需再手动安装astrojs/ts-plugints-plugin/README.md 开头也明确说明使用 Astro VS Code 扩展时该插件会自动安装并配置。只有在纯 TypeScript 工程不装 VS Code 扩展中想获得.astro导入支持时才需要手动npm install --save-dev astrojs/ts-plugin并在tsconfig.json的compilerOptions.plugins中添加{ name: astrojs/ts-plugin }。四、配置项详解扩展配置集中在 VS Code 设置中以astro.为前缀的命名空间下另可复用 VS Code 的html、css前缀配置以及typescript.*/javascript.*前缀的 TS 相关配置。以下是扩展自带配置项的完整清单与语义配置键类型默认值作用域说明astro.language-server.ls-pathstring空用户/工作区自定义语言服务器可执行文件路径仅在需要使用特定版本的语言服务器时设置绝大多数场景不需要astro.language-server.runtimestring空application用于启动语言服务器的 Node 可执行文件路径一般不需要astro.trace.serverstringoffwindow记录 VS Code 与语言服务器之间的 LSP 通信日志可选off/messages/verbose排查语言服务器通信问题时非常有用astro.content-intellisensebooleanfalseresource在 Markdown、MDX、Markdoc 内启用内容集合content collections的补全实验性支持。注意还必须在 Astro 配置中同步开启experimental.contentIntellisenseAstro 4.14astro.auto-import-cache.enabledbooleantrueresource是否启用自动导入缓存。启用可获得更快的自动导入补全但可能导致新文件不被及时识别改动需重启 VS Code 生效astro.updateImportsOnFileMove.enabledbooleanfalseresource移动文件时是否由本扩展自动更新相关导入路径。大多数情况下应保持关闭因为 TypeScript 与 Astro TS 插件已替你处理多个工具同时改导入可能导致文件损坏4.1 HTML / CSS / TypeScript 配置前缀README 特别说明了两套非astro.前缀的配置来源HTML 与 CSShtml、css前缀下的配置对.astro文件同样生效。例如想关闭悬停时的 HTML 文档说明设置html.hover.documentation: false即可。TypeScript在较新版本 VS Code 中TypeScript 相关设置会显示在设置界面的JavaScript and TypeScript (js/ts)分类下但其 JSON 键仍然使用typescript.*命名空间。例如typescript.preferences.importModuleSpecifier: non-relative控制自动导入的模块路径风格。注意配置时应修改 TypeScript 设置而非 JavaScript 设置——因为 Astro 的 frontmatter 本质是TypeScript-only脚本块语法基于 TS。4.2 格式化配置格式化的具体参数不通过astro.*配置暴露而是沿用 Prettier 的配置体系。你可以使用.prettierrc、prettier.config.js、package.json中的prettier字段或编辑器级设置等任意一种 Prettier 官方支持的配置方式。当前扩展内置的 Prettier 版本为 3.x 且搭配prettier-plugin-astro0.14.x见package.json依赖声明。4.3 扩展自带的命令除设置项外扩展还向命令面板注册了若干命令仅在打开.astro文件时可用可通过Ctrl/Cmd Shift P调用Astro: Reload Projects重新加载 Astro 项目语言服务器缓存的项目状态重置Astro: Find File References查找文件引用也出现在编辑器右键菜单与资源管理器上下文菜单中Astro: Select TypeScript Version...为当前工作区选择 TS 版本配合状态栏指示器Astro: Open TypeScript config快速打开tsconfig.json。这些命令分别对应client.ts中激活的activateReloadProjects、activateFindFileReferences、activateTsVersionStatusItem、activateTsConfigStatusItem等辅助逻辑。五、常见问题排查5.1 Inlay Hints内联提示不生效README 明确指出这是最常被问到的排错场景。原因与解决方案如下原因目前扩展只支持由 TypeScript 提供的 Inlay Hints而 TypeScript 的 Inlay Hints 默认是关闭的必须手动开启。由于 Astro 脚本块是纯 TypeScript需要配置的是typescript.inlayHints命名空间下的选项而不是javascript.inlayHints。解决办法在 VS Code 设置JSON中添加例如为函数实参启用参数名提示{ typescript.inlayHints.parameterNames.enabled: all }如果更习惯图形界面可以在设置 UI 中导航到TypeScript Inlay Hints Parameter Names进行勾选。关键在于更新TypeScript设置而非JavaScript设置。typescript.inlayHints下还有多种细分开关如变量类型提示、函数返回类型提示、参数名提示、隐式any提示等可以根据偏好组合开启。如果修改后仍不生效可尝试执行Astro: Reload Projects命令或在 VS Code 中重载窗口。5.2 需要自定义语言服务器版本时当需要测试或固定特定版本的语言服务器时可以设置astro.language-server.ls-path指向对应的服务器入口此时如果该路径配置在工作区内首次打开还会收到是否使用工作区语言服务器版本的询问。若怀疑语言服务器通信异常可将astro.trace.server切换为verbose查看 VS Code 输出面板中的 LSP 报文。六、小结Astro 的 VS Code 扩展本质是一个编排层它用 TextMate 语法与 VS Code 语言配置解决基础编辑体验把类型感知的智能能力委托给astrojs/language-server再通过astro-ts-plugin-bundle把.astro的类型系统打通进.ts/.js。理解这一分层后无论是配置补全与格式化、在纯 TS 工程中复用 ASTRO 类型支持还是排查 Inlay Hints 等疑难问题都能快速定位到正确的设置命名空间与对应源码。若需要为语言服务器本身做贡献或深入调试可从 packages/language-tools/vscode/test/grammar 的语法快照测试、vscode/src/client.ts 的启动逻辑以及 language-server 的服务端源码继续深挖。【免费下载链接】astroThe web framework for content-driven websites. ⭐️ Star to support our work!项目地址: https://gitcode.com/GitHub_Trending/as/astro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/8 19:25:35 · 阅读 1.2k Astro VS Code 扩展详解：`.astro` 语言支持、配置项与常见问题排查
Astro VS Code 扩展详解.astro语言支持、配置项与常见问题排查【免费下载链接】astroThe web framework for content-driven websites. ⭐️ Star to support our work!项目地址: https://gitcode.com/GitHub_Trending/as/astro本文围绕 packages/language-tools/vscode/README.md 展开结合当前仓库源码语言服务、TypeScript 插件、语法定义与测试用例深入讲解 Astro 官方 VS Code 扩展的能力边界、配置方式与排错方法。读完你将掌握如何配置该扩展、各配置项的精确作用域与默认值、Inlay Hints 为何不生效以及如何修复并理解其底层由语言服务器 TypeScript 插件共同驱动的架构。Astro 的官方 VS Code 扩展发布名Astro包名astro-vscode位于 packages/language-tools/vscode为.astro文件提供完整的语言支持语法与语义高亮、诊断信息、智能补全、格式化、符号导航、悬停信息、跳转定义、Inlay Hints、代码折叠、代码片段与文件模板等。所有语言能力并非在扩展内部自研而是由 Astro 语言服务器astrojs/language-server位于 packages/language-tools/language-server 提供扩展本身只负责启动语言服务器并桥接 VS Code 与它之间的通信。此外扩展还内置打包了一个 TypeScript 插件让.ts/.js文件同样可以识别并正确处理.astro组件的导入与导出。一、扩展整体架构语言服务器 TypeScript 插件从 vscode/package.json 的依赖与入口可以看出该扩展的分层结构main指向./dist/node/client.js即 LSPLanguage Server Protocol客户端入口实际语言能力来自astrojs/language-server见 packages/language-tools/language-server通过contributes.typescriptServerPlugins注册名为astro-ts-plugin-bundle的 TypeScript 服务端插件开启enableForWorkspaceTypeScriptVersions对应独立发包 astrojs/ts-plugin源码在 packages/language-tools/ts-plugin扩展同时声明了astrojs/compiler、prettier与prettier-plugin-astro作为运行时依赖——这正是格式化由 Prettier prettier-plugin-astro 驱动这一结论的直接依据。客户端启动逻辑在 vscode/src/client.ts 中有完整呈现扩展读取astro.language-server配置段来确定语言服务器路径与运行时随后创建LanguageClient并通过 IPC 传输启动服务器。其中两个值得注意的细节自定义语言服务器路径client.ts中的getConfiguredServerPath()会依次检查全局/默认值以及工作区各层级的ls-path配置若工作区内存在自定义语言服务器路径首次打开时还会弹窗询问用户是否使用工作区内的语言服务器版本可选择Allow、Dismiss或Never in This Workspace。Content IntelliSense 开关驱动文档选择器当astro.content-intellisense开启时语言客户端才会把markdown、mdx、markdoc文档也纳入服务范围用于内容集合的类型补全。正是这种薄客户端 语言服务器 TS 插件的架构使得 VS Code、编辑器通过通用 LSP与纯 TypeScript 工程能共享同一套 Astro 语言智能。二、功能总览README 中列出的功能覆盖了一个现代编辑器语言支持应有的全部维度可以整理为下表以便速查能力类别说明语法与语义高亮基于 TextMate 语法syntaxes 目录下的 tmLanguage 文件 TypeScript 语义级高亮诊断信息错误与警告Diagnostics由语言服务器在编辑时实时上报IntelliSense 补全支持自动导入auto-imports的补全Emmet 补全在 HTML 与 CSS 上下文内生效组件 Props 补全对 JSX/TSX、Vue仅 Composition API与 Svelte 组件的 Props 提供补全Code Actions快速修复、排序导入等格式化由 Prettier 与 prettier-plugin-astro 驱动符号与导航大纲视图、面包屑、Go to Symbol、悬停信息、Go to Definition / Type Definition / ImplementationInlay Hints由 TypeScript 提供详见下文常见问题代码折叠配合语言配置中的折叠标记片段与文件模板随扩展内置的page_html、page_layout、component模板2.1 语法与语义高亮.astro文件的语法定义位于 vscode/syntaxes 目录包含三套 TextMate 语法astro.tmLanguage.json源定义是astro.tmLanguage.src.yaml核心语法负责source.astro作用域markdown.astro.tmLanguage.json注入到text.html.markdown与source.astro用于在 Markdown/.astro内嵌块中正确着色mdx.astro.tmLanguage.json注入到source.mdx处理 MDX 中内嵌的 Astro 代码块。package.json的contributes.grammars中通过embeddedLanguages声明了丰富的内嵌语言映射包括 HTML、Markdown、CSS含 Less/SCSS/Sass/Stylus、JavaScript、TypeScript、TSX、JSON 等这是.astro单文件里混写模板、script与style仍能获得正确高亮的原因。扩展仓库还配套了一套语法快照测试见 vscode/test/grammarfixtures 覆盖了组件、script事件/表达式/多行 TS、style的 Less/Sass/SCSS/Stylus/property等大量边界场景每个.astro用例都有对应的.snap快照用于防止语法高亮回归。2.2 格式化格式化能力由扩展内置的 Prettier 与 prettier-plugin-astro 提供见package.json的dependencies。因此 Prettier 的各种配置方式配置文件、editorconfig、VS Code settings 等对该扩展同样生效你可以把.prettierrc、prettier.config.js或astro专属格式化选项放入项目根目录来统一团队格式。2.3 组件 Props 补全与其他框架协同在.astro模板中 import React、Vue、Svelte 组件后编辑器会基于组件自身的 Props 类型推导补全。README 特别说明Vue 仅支持 Composition API 下的补全。此外扩展为 JSX/TSX、Vue、Svelte 组件提供统一的 Props 补全体验这是语言服务器与对应框架的语言能力协同工作的结果。2.4 代码片段与文件模板扩展内置了三个以.astro文件为作用域的文件模板定义在 languages/astro.code-snippetspage_html生成带完整html骨架的页面page_layout生成引用某个Layout组件的页面component生成最基础的组件骨架空 frontmatter 模板。在资源管理器 / 编辑器内新建.astro文件时即可从这些模板起步快速创建页面或组件。2.5 编辑体验细节vscode/languages/astro-language-configuration.json 定义了该语言的编辑器级行为包括括号自动配对含{/* */}、!-- --、/** */、注释块!-- --、折叠标记!-- #region --以及基于正则的智能缩进规则。package.json中还注册了breakpoints语言级断点与自动补全等能力方便在语言服务器内部进行调试。三、安装与激活条件扩展本身可通过 VS Code 扩展市场安装搜索Astro发布方为astro-build。从 vscode/package.json 可确认几个与安装运行相关的关键约束VS Code 版本要求engines.vscode为^1.101.0即需要 VS Code 2025 年 5 月版本1.101.0及以上CHANGELOG 中记录了该最低版本要求的上调激活时机activationEvents仅包含workspaceContains:astro.config.*——当你打开的工作区中出现astro.config.mjs、astro.config.ts等配置文件时扩展才会激活这保证了它不会在无关工作区中空转自动附带 TS 插件如前所述扩展通过typescriptServerPlugins自动配置 TS 插件因此使用本扩展时无需再手动安装astrojs/ts-plugints-plugin/README.md 开头也明确说明使用 Astro VS Code 扩展时该插件会自动安装并配置。只有在纯 TypeScript 工程不装 VS Code 扩展中想获得.astro导入支持时才需要手动npm install --save-dev astrojs/ts-plugin并在tsconfig.json的compilerOptions.plugins中添加{ name: astrojs/ts-plugin }。四、配置项详解扩展配置集中在 VS Code 设置中以astro.为前缀的命名空间下另可复用 VS Code 的html、css前缀配置以及typescript.*/javascript.*前缀的 TS 相关配置。以下是扩展自带配置项的完整清单与语义配置键类型默认值作用域说明astro.language-server.ls-pathstring空用户/工作区自定义语言服务器可执行文件路径仅在需要使用特定版本的语言服务器时设置绝大多数场景不需要astro.language-server.runtimestring空application用于启动语言服务器的 Node 可执行文件路径一般不需要astro.trace.serverstringoffwindow记录 VS Code 与语言服务器之间的 LSP 通信日志可选off/messages/verbose排查语言服务器通信问题时非常有用astro.content-intellisensebooleanfalseresource在 Markdown、MDX、Markdoc 内启用内容集合content collections的补全实验性支持。注意还必须在 Astro 配置中同步开启experimental.contentIntellisenseAstro 4.14astro.auto-import-cache.enabledbooleantrueresource是否启用自动导入缓存。启用可获得更快的自动导入补全但可能导致新文件不被及时识别改动需重启 VS Code 生效astro.updateImportsOnFileMove.enabledbooleanfalseresource移动文件时是否由本扩展自动更新相关导入路径。大多数情况下应保持关闭因为 TypeScript 与 Astro TS 插件已替你处理多个工具同时改导入可能导致文件损坏4.1 HTML / CSS / TypeScript 配置前缀README 特别说明了两套非astro.前缀的配置来源HTML 与 CSShtml、css前缀下的配置对.astro文件同样生效。例如想关闭悬停时的 HTML 文档说明设置html.hover.documentation: false即可。TypeScript在较新版本 VS Code 中TypeScript 相关设置会显示在设置界面的JavaScript and TypeScript (js/ts)分类下但其 JSON 键仍然使用typescript.*命名空间。例如typescript.preferences.importModuleSpecifier: non-relative控制自动导入的模块路径风格。注意配置时应修改 TypeScript 设置而非 JavaScript 设置——因为 Astro 的 frontmatter 本质是TypeScript-only脚本块语法基于 TS。4.2 格式化配置格式化的具体参数不通过astro.*配置暴露而是沿用 Prettier 的配置体系。你可以使用.prettierrc、prettier.config.js、package.json中的prettier字段或编辑器级设置等任意一种 Prettier 官方支持的配置方式。当前扩展内置的 Prettier 版本为 3.x 且搭配prettier-plugin-astro0.14.x见package.json依赖声明。4.3 扩展自带的命令除设置项外扩展还向命令面板注册了若干命令仅在打开.astro文件时可用可通过Ctrl/Cmd Shift P调用Astro: Reload Projects重新加载 Astro 项目语言服务器缓存的项目状态重置Astro: Find File References查找文件引用也出现在编辑器右键菜单与资源管理器上下文菜单中Astro: Select TypeScript Version...为当前工作区选择 TS 版本配合状态栏指示器Astro: Open TypeScript config快速打开tsconfig.json。这些命令分别对应client.ts中激活的activateReloadProjects、activateFindFileReferences、activateTsVersionStatusItem、activateTsConfigStatusItem等辅助逻辑。五、常见问题排查5.1 Inlay Hints内联提示不生效README 明确指出这是最常被问到的排错场景。原因与解决方案如下原因目前扩展只支持由 TypeScript 提供的 Inlay Hints而 TypeScript 的 Inlay Hints 默认是关闭的必须手动开启。由于 Astro 脚本块是纯 TypeScript需要配置的是typescript.inlayHints命名空间下的选项而不是javascript.inlayHints。解决办法在 VS Code 设置JSON中添加例如为函数实参启用参数名提示{ typescript.inlayHints.parameterNames.enabled: all }如果更习惯图形界面可以在设置 UI 中导航到TypeScript Inlay Hints Parameter Names进行勾选。关键在于更新TypeScript设置而非JavaScript设置。typescript.inlayHints下还有多种细分开关如变量类型提示、函数返回类型提示、参数名提示、隐式any提示等可以根据偏好组合开启。如果修改后仍不生效可尝试执行Astro: Reload Projects命令或在 VS Code 中重载窗口。5.2 需要自定义语言服务器版本时当需要测试或固定特定版本的语言服务器时可以设置astro.language-server.ls-path指向对应的服务器入口此时如果该路径配置在工作区内首次打开还会收到是否使用工作区语言服务器版本的询问。若怀疑语言服务器通信异常可将astro.trace.server切换为verbose查看 VS Code 输出面板中的 LSP 报文。六、小结Astro 的 VS Code 扩展本质是一个编排层它用 TextMate 语法与 VS Code 语言配置解决基础编辑体验把类型感知的智能能力委托给astrojs/language-server再通过astro-ts-plugin-bundle把.astro的类型系统打通进.ts/.js。理解这一分层后无论是配置补全与格式化、在纯 TS 工程中复用 ASTRO 类型支持还是排查 Inlay Hints 等疑难问题都能快速定位到正确的设置命名空间与对应源码。若需要为语言服务器本身做贡献或深入调试可从 packages/language-tools/vscode/test/grammar 的语法快照测试、vscode/src/client.ts 的启动逻辑以及 language-server 的服务端源码继续深挖。【免费下载链接】astroThe web framework for content-driven websites. ⭐️ Star to support our work!项目地址: https://gitcode.com/GitHub_Trending/as/astro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考