Node.js 实现全栈统一的关键在于统一语言、运行时模型、工具链和思维方式，而非简单共用代码；真正可行的共用限于工具函数、TypeScript类型定义、配置常量三类场景，且需规避环境特有API。
JavaScript 全栈开发不是指用 JS 写完前后端就叫全栈，而是指用同一套语言、运行时模型、工具链和思维方式去构建服务端逻辑与浏览器交互——Node.js 是实现这个统一的关键枢纽，但它本身不自动“统一”，需要主动设计边界与协作契约。
Node.js 怎么让前后端共用代码？
共用 ≠ 直接把 fetch 丢进 Node.js 运行，也不等于把 React 组件直接 require 到 Express 路由里。真正可行的共用集中在三类场景：
- 工具函数（如日期格式化、URL 参数解析）：抽成独立
.js文件，用export/import或module.exports/require，注意避开浏览器或 Node 特有 API（比如不要在共用模块里写document.getElementById或fs.readFileSync） - 类型定义（TypeScript）：
.d.ts文件可被前后端同时引用，例如统一的接口响应结构ApiResponse<T> - 配置与常量：API 地址前缀、错误码映射表等，可导出为 JSON 或 JS 模块，但需注意环境变量注入时机——前端要通过构建时替换（如 Webpack 的
DefinePlugin），后端走process.env
为什么不能直接用同一个 Express 路由处理前端路由和 API？
这是初学者最常踩的坑：app.get('/user/:id', ...) 既是 API 接口，又想当 SPA 的前端路由兜底，结果导致页面刷新 404 或数据加载异常。
根本矛盾在于职责混淆：
立即学习“Java免费学习笔记（深入）”；
- API 路由必须返回结构化数据（JSON），状态码有意义（404 表示资源不存在）
- 前端路由兜底（如
app.get('*', ...)）应只返回 HTML 模板或静态文件，且状态码必须是 200（否则搜索引擎/SPA 路由器会误判） - 两者中间件栈也不同：API 需
body-parser、鉴权；HTML 渲染需模板引擎、静态资源托管
正确做法是分层：API 走 /api/xxx 前缀，前端路由由客户端（React Router / Vue Router）接管；服务端仅对非 API 请求返回 index.html。
Node.js 真正统一的是什么？而不是什么？
统一的是底层能力模型和工程一致性，不是运行环境或执行上下文：
- ✅ 统一包管理：前后端都用
package.json+node_modules，共享eslint、prettier、jest配置 - ✅ 统一异步范式：都是基于 Promise / async-await，事件循环模型一致（虽然浏览器有 microtask/task 区分，Node 有
process.nextTick，但语义趋同） - ❌ 不统一 DOM 操作：Node.js 没有
document，前端不能直接调用fs，也不能指望localStorage在服务端存在 - ❌ 不统一构建目标：前端代码必须经过打包（如 Vite/Webpack），输出浏览器可执行的 JS；后端代码可直接
node index.js，但要注意 ESM/CJS 差异（type: "module"会影响require行为）
const { createServer } = require('node:http');
const { readFile } = require('node:fs').promises;
// 示例：一个极简但职责清晰的服务端
createServer(async (req, res) => {
if (req.url.startsWith('/api/')) {
res.setHeader('Content-Type', 'application/json');
res.end(JSON.stringify({ data: 'from api' }));
} else {
// 非 API 请求 → 返回前端 HTML（注意：状态码必须是 200）
const html = await readFile('./dist/index.html');
res.setHeader('Content-Type', 'text/html');
res.end(html);
}
}).listen(3000);
复杂点永远在边界上：哪些逻辑该放在前端做（如表单校验）、哪些必须由后端兜底（如权限验证）、共用模块如何避免循环依赖、SSR 时 window 对象未定义的报错……这些没法靠 Node.js 自动解决，得靠人划清线。
