服务端渲染需实现同构代码，核心是隔离环境差异。1. 避免直接使用 window 等浏览器对象，通过 typeof window 判断执行环境；2. 统一采用 es module 语法，由构建工具处理 commonjs 兼容性，动态导入浏览器专用模块；3. 使用构建插件注入环境变量，区分开发、生产及客户端配置，防止敏感信息泄露；4. 封装跨平台请求库，在服务端预取数据时避免依赖 fetch 或浏览器存储。关键在于共享逻辑、控制副作用边界，借助工具抹平运行时差异，确保代码在 node.js 与浏览器中均可正确执行。

服务端渲染（SSR）中，JavaScript 代码需要同时运行在 Node.js 和浏览器环境，而这两个环境存在明显差异。要解决这些差异，核心是识别并隔离环境特有的逻辑，确保代码在两边都能正确执行。

1. 避免使用浏览器专有对象

Node.js 环境没有 window、document、navigator 等浏览器全局对象。直接访问会导致服务端报错。

处理方式：

• 在使用前判断对象是否存在，例如：
  if (typeof window !== 'undefined') { /* 浏览器逻辑 */ }
• 将依赖 DOM 的操作延迟到组件挂载后（如 React 的 useEffect 或 Vue 的 mounted 钩子）
• 对第三方库做条件引入或替换，避免服务端执行浏览器专属代码

2. 处理模块系统差异

Node.js 默认使用 CommonJS（require/module.exports），而现代前端多用 ES Modules（import/export）。构建工具如 Webpack 或 Vite 会统一处理，但仍需注意兼容性。

建议：

Zenlink - Node SDK for ZenHeart

ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。

下载

• 统一采用 ES Module 语法，由构建工具负责转换
• 服务端若使用原生 ESM，需在 package.json 中设置 "type": "module"
• 动态导入（import()）可用于按需加载浏览器专用模块

3. 管理环境变量和配置

不同环境可能需要不同的 API 地址、功能开关等。

做法：

• 通过构建时注入环境变量区分，如 process.env.NODE_ENV
• 使用 define 插件（Vite）或 DefinePlugin（Webpack）将变量编译进代码
• 避免在服务端暴露敏感信息，仅传递必要的客户端配置

4. 统一数据获取方式

浏览器可用 fetch，Node.js 可能需要 polyfill 或使用 node-fetch、axios 等跨平台库。

推荐：

• 封装请求模块，内部根据环境选择实现
• 在 SSR 数据预取阶段，服务端直接调用接口获取数据，避免依赖客户端 fetch
• 确保请求不依赖 cookie 或 localStorage 等浏览器存储

基本上就这些。关键是写“同构”代码：共享逻辑，隔离副作用，借助构建工具抹平差异。只要控制好边界，Node.js 和浏览器可以和谐共处。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南