-
使用gap与repeat(auto-fill,minmax())实现响应式网格布局，通过grid-template-columns设置最小列宽并自动填充，gap确保项目间距均匀；为避免边缘不对齐，可采用justify-content:space-between配合max-content控制分布，或保留1fr实现等宽自适应；配合padding替代margin防止溢出，确保布局整齐无滚动条。
-
flex-wrap后justify-content:center不居中，因其仅对每行内子项生效，末行子项不足时靠左；真正整体居中应选grid布局或text-align+inline-flex方案。
-
不能。PyCharm无法直接调试index.html，因其为前端静态文件，无Python解释器参与；需通过HTTP服务（如http.server、Flask或JavaScriptDebug配置）在浏览器中运行并调试JS。
-
ref可安全获取DOM元素或子组件实例，需模板绑定同名ref属性、脚本中用ref(null)声明，并在onMounted后通过value访问；绑定子组件时须配合defineExpose暴露内容。
-
margin-inline和padding-block是逻辑属性，行为由direction和writing-mode决定；正确设置二者并配合dir属性即可自动适配RTL，无需手动切类或写两套规则。
-
JavaScript选取HTML元素应优先用document.getElementById()（最快，需id唯一）、querySelector()（灵活支持CSS选择器，只返首个）、querySelectorAll()（返全部匹配节点，返回静态NodeList）；慎用getElementsByTagName等动态集合方法。
-
应使用transform替代display控制侧边栏显隐：初始设transform:translateX(-100%)实现默认隐藏，点击触发.open类改为translateX(0)实现滑入动画；同时需用stopPropagation()阻止事件冒泡，避免点击菜单自身导致关闭，并采用flex布局让主内容区自适应避让。
-
items-center单独无法垂直居中，因为它仅在flex容器的交叉轴生效，需父容器设display:flex（或flex-col）、有明确高度（如min-h-screen），且主轴方向决定交叉轴方向；最稳妥方案是flex+items-center+justify-center同时作用于同一父容器。
-
1frminmax(0,1200px)1fr不适合实现固定留白，因两侧1fr动态均分剩余空间，导致留白不固定、小屏塌缩、浏览器兼容性差；可靠方案是margin:0auto+max-width或minmax(最小像素,1fr)配合明确下限。
-
functools.wraps是必选项，否则原函数的__name__、__doc__、__annotations__丢失，导致日志、监控、OpenAPI工具无法识别真实函数；埋点需用try-except兜底，禁用同步HTTP请求；带参装饰器须冻结参数避免闭包污染；Annotated仅作类型提示，无法替代运行时埋点逻辑。
-
应使用<code>标签包裹短小技术名词（如fetch()），用<pre><code>组合展示多行代码；<code>不保留换行缩进，且HTML特殊字符必须转义。
-
动画在页面切到后台后“停止”不是bug，而是浏览器主动节电行为；直接设animationPlayState="running"无效，因时间轴未重置、iOSSafari兼容性差且终态无法重启，必须通过class移除→强制reflow→class重加三步触发DOM重解析实现可靠重播。
-
<p>可使用HTML注释语法<!---->包裹段落以实现标识而不影响渲染，支持添加【段落】等前缀增强可读性，但不可嵌套注释，需用独立注释块替代。</p>
-
backdrop-filter模糊发灰需叠加saturate(160%–190%)补色，必须与blur同声明；确保父容器有可模糊内容且无overflow:hidden截断；深色模式用低饱和深灰rgba基底；iOS旧版需双条件@supports检测，X5内核等须降级。
-
在Blazor中，通过@ref调用子组件方法（如Show()/Hide()）时，若未显式触发重渲染，绑定的条件类（如@(Display?"show":"")）不会自动更新——需手动调用StateHasChanged()。
