domestic-stacklisted

# 国内技术栈适配 ## 何时用 - 开发微信小程序或 uniapp 项目，涉及页面、组件、API 调用时。 - 写 uniapp 多端适配逻辑，需要区分 APP / 小程序 / H5 平台差异时。 - 开发 SpringBoot 后端接口，涉及 Controller / Service / Mapper 分层设计时。 - 项目上线前检查合规、依赖源、CDN 等国内环境配置时。 ## 核心规则 ### 1. 小程序/uniapp 不照搬 web **规则：** 微信小程序和 uniapp 运行在专属运行时，没有 `window`、`document`、`localStorage` 等 DOM/BOM 对象；`setData` 是性能敏感操作，频繁调用或传大对象会直接卡顿；整包 + 分包体积有硬性上限（主包 2 MB，总包 20 MB）。 **为什么：** AI 训练数据以 web 代码为主，极容易写出 `document.querySelector`、`window.location.href`、`localStorage.setItem` 这类在小程序里直接报 `ReferenceError` 的代码。对 `setData` 的误用更隐蔽：AI 常常在循环里每次更新一个字段就调用一次 `setData`，或者把整个巨型列表塞进去，运行时帧率立刻掉到个位数。 **怎么做：** - 访问本地存储用 `wx.setStorageSync` / `uni.setStorageSync`，路由用 `wx.navigateTo` / `uni.navigateTo`，DOM 操作改用数据绑定驱动视图。 - 批量更新时合并成一次 `setData`，用 path 精确更新而非替换整个对象（见正例）。 - 拆分包：业务模块放分包，避免主包塞太多资源；图片走 CDN 不打进包里。 --- ### 2. uniapp 跨端用条件编译 **规则：** uniapp 跨 APP / 微信小程序 / H5 时，平台差异必须用 `#ifdef APP-PLUS` / `#ifdef MP-WEIXIN` / `#ifdef H5` 等条件编译块处理，不写死只在单端能跑的逻辑。 **为什么：** AI 在生成 uniapp 代码时经常直接调用 `wx.*` API 而不加条件编译，在 APP 端或 H5 端运行时这些调用会静默失败或抛异常。反过来也会犯：只写了 `plus.*` 的 APP 专属逻辑，发布 H5 版时整块功能缺失。这类 bug 在单端开发阶段完全看不出来，到多端上线时才暴露。 **怎么做：** - 平台专属 API 用条件编译包裹，公共逻辑放在块外。 - 样式差异用 `/* #ifdef MP-WEIXIN */` 包裹对应 CSS。 - 构建产物检查：每次改动后分别在小程序、H5 模式各跑一遍，确认两端都正常。 --- ### 3. 微信登录走官方流程 **规则：** 微信登录必须走 `wx.login` 获取 code，再由后端调用 `code2session` 换取 openid 和 session_key；openid 和 session_key 不得存在前端，不得绕过授权步骤直接用 union_id 或手机号作为身份标识。 **为什么：** AI 经常写出把 `session_key` 存进 `wx.setStorageSync` 的代码——这违反微信安全规范，session_key 会失效且不能直接暴露给客户端。还