前端静态站点Web框架【免费下载链接】gatsbyReact-based framework with performance, scalability, and security built in.项目地址https://gitcode.com/gh_mirrors/ga/gatsby点击查看免费下载本指南基于仓库中的 v5.4 发布说明 编写系统梳理 Gatsby 5.4.02023 年 1 月 10 日发布的核心变更依赖安全更新、gatsby-node目录化支持、SlicePlaceholderPropsTypeScript 类型改进以及 file-loader 资源路径回归修复。读完本文你将能快速判断升级到gatsby5.4.0的影响面掌握把gatsby-node拆分为目录结构的正确写法并理解 Slice 占位组件在类型层面的约束。版本概览与升级背景gatsby5.4.0是 2023 年 1 月的第一次版本发布。团队在经历冬季假期前完成了大量维护工作更新内部依赖、修复零散 bug并在上一个版本 v5.3 中引入了 ES ModulesESM支持——从 5.3 开始gatsby-config.mjs与gatsby-node.mjs可以直接使用 ESM-only 包TypeScript 变体暂不支持 ESM。5.4.0 没有引入新的重磅特性重点落在安全修复、类型完善与回归修补上。如果你希望第一时间体验未发布的特性可以安装gatsbynext渠道版本生产环境建议基于本文的变更清单评估后再升级。依赖维护与安全修复本次发布合并了 40 多个 renovate 机器人提交的依赖更新 PR覆盖多个包的依赖升级。其中两项与安全直接相关升级socket.io以修复 CVE-2022-41940该漏洞影响 socket.io 的跨站请求伪造防护能力Gatsby 通过 bump 版本解决此问题对应 PR #37272。升级yaml-loader从 0.6.0 到 0.8.0用于消除依赖扫描中的安全告警对应 PR #37401。在 packages/gatsby/CHANGELOG.md 的 5.4.0 条目中可以看到完整变更集合除上述两项外还包括Parcel 升级至 v2.8.2PR #37383修复从.mjs文件中提取 GraphQL query 的问题PR #37320修复gatsby-plugin-sharp多实例初始化问题PR #37306不再将 file-loader 处理的资源输出到.cache目录PR #37284导入gatsby-config/gatsby-node时改用file://协议PR #37257改善 page data 与长时间运行 query 告警的可读性PR #37220从 changelog 结构可以看到5.4.0 属于典型的维护型minor 版本无破坏性变更升级成本低主要收益是依赖安全性与稳定性。新能力gatsby-node目录化支持5.4.0 允许将gatsby-node以目录形式组织例如root/gatsby-node/on-pre-init.tsPR #36712。在此之前gatsby-node只能作为单个文件存在.js/.ts/.mjs等现在你可以把不同生命周期钩子拆分为独立模块再在入口文件汇总导出。仓库中提供了对应的测试 fixture 作为参考实现gatsby-node-as-directory/gatsby-node.tsimport { onPreInit } from ./gatsby-node/on-pre-init export { onPreInit }实际目录结构如下root/ ├── gatsby-node/ # 目录化后的 gatsby-node 模块 │ └── on-pre-init.ts # 单个生命周期钩子 └── gatsby-node.ts # 入口汇总并重新导出这种组织方式适合钩子较多的项目每个钩子独立成文件、各自维护入口文件只做 re-export便于测试与代码审查。注意该能力基于 Parcel 编译管线fixture 位于packages/gatsby/src/utils/parcel/__tests__/下说明 5.4.0 之后的gatsby-node处理统一走 Parcel 编译流程。类型改进SlicePlaceholderPropsgatsby包在本次发布中优化了SlicePlaceholderProps的 TypeScript 类型PR #37409为使用 Slice API 的开发者提供更严格的类型约束。该接口定义在 packages/gatsby/index.d.tstype SerializableProps | ISerializableObject | ArraySerializableProps | string | number | boolean | null | undefined interface ISerializableObject { [key: string]: SerializableProps } export interface SlicePlaceholderProps { alias: string allowEmpty?: boolean children?: React.ReactNode [key: string]: SerializableProps | React.ReactNode }从类型定义可以读出 Slice 占位组件的约束alias: string必填指向要插入的 Slice 名称allowEmpty?: boolean可选允许空内容占位children?: React.ReactNode占位期间可渲染的后备内容其余自定义 props 必须满足SerializableProps——即只允许可序列化的 JSON 数据类型字符串、数字、布尔、数组、可序列化对象这是为了保证 Slice 的 props 能跨渲染引擎Rendering Engines传递。配套导出的SliceComponentPropsDataType, SliceContextType, AdditionalSerializableProps则约束了 Slice 组件本身收到的 propsdata、sliceContext与可序列化附加属性。这意味着占位处传入的 props与Slice 组件收到的 props在类型层面被对齐任何不可序列化的值如函数、Date 实例都会被 TypeScript 拦截——这恰好印证了 Slice 机制渲染时独立于页面的架构设计。回归修复file-loader 资源的 asset 与 path prefix5.4.0 恢复了 file-loader 处理文件的asset 与 path prefix行为PR #37429修复了gatsby5.3.3中引入的回归。此前在 5.3.3 中引入了不把 file-loader 资源输出到.cache的改动但连带破坏了资源在前缀路径pathPrefix与 asset 输出上的处理5.4.0 在保留.cache清理的同时补回了这两项行为。这一修复对使用pathPrefix部署到子路径如 GitHub Pages 站点仓库的项目尤其重要——资源 URL 会重新带上正确的前缀避免构建产物中出现 404 引用。文档与杂项调整本次还包含若干低风险的文档与配置修正均可在仓库中溯源调整createRedirect中trailingSlash选项的相关说明PR #37259。trailingSlash配置在gatsby-config.js中控制页面路径尾部斜杠策略对应源码 packages/gatsby/src/redux/actions/public.js 中的const { trailingSlash } config该 PR 确保重定向行为的文档与实际实现一致。修正 reference 指南中的文档拼写错误PR #37347。更新 Storybook 配置说明PR #37321与.gitpod的 Node 版本PR #37336。这些变更不涉及运行时行为但体现了发布前对文档质量的统一梳理。社区贡献本版本汇集了多位社区成员的贡献包括Simply007调整createRedirect中trailingSlash的文档信息bicstone修正 reference 指南拼写demondragong修正gatsby-plugin-google-analyticsREADME 拼写markacola更新.gitpodNode 版本openscript清理 how-to 文档中不必要的解构trentschnee更新 Storybook 说明xavivars为gatsby-source-contentful的 Joi schema 添加contentTypeFilter支持PR #37403。其中contentTypeFilter的合入意味着gatsby-source-contentful在配置校验层面正式支持按内容类型过滤数据源值得使用 Contentful 的开发者关注。升级建议总结安全收益明确socket.ioCVE-2022-41940与yaml-loader均属直接安全修复建议及时升级无破坏性变更5.4.0 以依赖维护与 bugfix 为主从 5.3.x 升级风险低可立即使用的新能力gatsby-node目录化组织、SlicePlaceholderProps类型完善验证回归修复使用pathPrefix或依赖 file-loader 资源的项目升级后可重点回归资源 URL 与asset输出路径。若需要完整的逐条变更可直接查阅 packages/gatsby/CHANGELOG.md 中5.4.0一节或对比 v5.3 发布说明 了解上一个版本引入的 ESM 能力。赞分享前端静态站点Web框架【免费下载链接】gatsbyReact-based framework with performance, scalability, and security built in.项目地址https://gitcode.com/gh_mirrors/ga/gatsby点击查看免费下载相关推荐Gatsby 5.3.0 发布说明gatsby-config / gatsby-node 原生 ESM 支持与错误信息可读性改进Gatsby 5.3.0 发布说明gatsby config / gatsby node 原生 ESM 支持与错误信息可读性改进 本文围绕 Gatsby 5.前端静态站点Web框架Gatsby v5.14.0 发布说明解读安全修复、遥测策略调整与开发体验改进Gatsby v5.14.0 发布说明解读安全修复、遥测策略调整与开发体验改进 导读 本文围绕 Gatsby 官方发布的 gatsby5.14.0 20前端静态站点Web框架Gatsby 5.11 发布详解Adapter 部署新架构与 gatsby-source-wordpress 多实例支持Gatsby 5.11 发布详解Adapter 部署新架构与 gatsby source wordpress 多实例支持 gatsby5.11.0 202前端静态站点Web框架创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考