技术

给小白的 Java 后端冲刺教程：用故事建立直觉，用一个小项目把面试高频知识串起来。

记录这次站点改造：为什么选择 Astro、如何拆分内容模块，以及怎样用统一布局把页面变成一个可持续维护的技术档案。

从目标、约束、信息架构到验证，把一个看似复杂的个人站拆成可以逐步完成的小问题。

Astro 默认优先输出静态 HTML，适合内容站点，也能在需要时局部引入交互组件。

内容集合用 schema 约束 Markdown 数据，能把内容校验和页面渲染分开维护。

布局组件负责统一 HTML 壳层、元信息和导航，页面只关注内容结构。

静态路径生成让同一套页面模板承载多个内容条目，路径和数据之间保持可追踪。

图片组件可以在构建阶段处理尺寸与格式，减少手动维护图片属性的负担。

Vite 用原生 ESM 加快开发反馈，生产构建则通过 Rollup 组织最终资源。

公开变量和服务器变量必须区分，前端打包后的变量不应存放敏感凭据。

类型守卫把宽类型逐步收窄到可用分支，能减少运行时才暴露的空值问题。

接口描述数据契约，先确定输入输出形状，再决定实现细节，能降低模块耦合。

泛型把类型关系保留下来，比直接使用 any 更能表达可复用函数的约束。

strict 选项让类型检查更完整，迁移旧代码时可以分阶段收紧而不是一次性推倒重来。

Lint 规则适合捕获一致性和高频错误，复杂规则应结合团队实际而不是盲目堆叠。

格式化工具把争论从代码风格中移开，让评审更专注于行为和设计。

单元测试应该围绕可观察行为编写，测试边界条件比追求行覆盖率更重要。

浏览器测试覆盖真实导航、表单和响应式状态，适合验证关键用户路径。

性能、可访问性、最佳实践和 SEO 应该在发布前形成固定检查项。

一次提交只解决一个问题，提交说明写清动机和影响，后续回溯会更容易。

分支是隔离变化的工具，不应替代小提交和持续集成，合并前要确保验证结果可复现。

把构建、检查和部署写成可重复的工作流，减少“本地能跑、服务器失败”的差异。

把重复的检查和生成步骤收敛到 package scripts，团队成员可以用同一个入口执行。

工作区可以共享依赖和脚本，适合多个前端包之间的统一管理。

按路由和功能拆分资源，让首屏只加载当前任务真正需要的代码。

preload 和 preconnect 只能服务于明确的关键资源，滥用会增加竞争和浪费。

静态站点部署的核心是正确的根目录、回退策略、缓存头和压缩配置。

构建环境和运行环境分离，可以减小镜像体积并降低生产环境复杂度。

CSP、HSTS、X-Content-Type-Options 等响应头可以作为部署层的基础防线。

用户界面需要把可恢复错误、空状态和不可恢复错误分开表达，避免统一显示白屏。

把首屏资源、图片体积和交互延迟写成可检查的预算，性能才不会只停留在感觉。

好的技术记录包含背景、约束、方案、验证和下一步，而不是只罗列使用过的工具。

用加载时间、交互响应和布局稳定性等指标描述性能，再为页面设定可验证的预算，优化才不会停留在感觉层面。