有没有在Node.js里同时用过require和import？是不是经常遇到这两种写法打架的情况？今天咱们就来聊聊怎么让新旧模块系统和平共处，手把手教你从CommonJS丝滑过渡到ES6！

一、先搞明白为什么非要过渡（老司机也会翻车）

去年我接手个老项目，满屏的require看着就头疼。等我想用ES6新特性时，突然发现——??import和require混用会报错！?? 这时候才明白，模块系统升级不是换个写法这么简单。

??CommonJS的三大痛点：??

1. ??同步加载??拖慢启动速度（特别是大型项目）
2. ??无法tree-shaking??（打包时删不掉无用代码）
3. ??浏览器不兼容??（想搞同构渲染都费劲）

举个真实案例：有个电商项目打包后2.3MB，改用ES6模块+webpack优化，直接瘦身到890KB。这差距，你懂的！

二、过渡前的准备工作（别急着改代码）

??第一步：给项目拍个快照??

bash复制
git commit -am "迁移前的代码备份"

??划重点：?? 这步不做，可能哭着改回老代码！

??第二步：检查Node版本??
打开终端敲这个：

bash复制
node -v

必须≥14.13.0！2020年之前的版本直接劝退ES模块。

??第三步：修改package.json??
加这两行救命符：

json复制
{
  "type": "module",
  "exports": "./index.js"
}

这时候你可能会问：??加了type:module还能用require吗？?? 问得好！只要文件后缀改成.cjs就行，就像这样：

javascript复制
// legacy.cjs
module.exports = { /* 老代码不动 */ }

三、实战迁移四步法（手把手教学）

??阶段1：新文件用ES6，老文件暂时不动??

• 新建的.js文件统统用import/export
• 老文件保持require写法

??阶段2：逐步替换核心模块??
优先改造这三大件：

1. 工具类utils.js
2. 配置config.js
3. 路由router.js

??阶段3：处理第三方库??
遇到这种情况怎么办？

javascript复制
// 报错！lodash没装ESM版本
import _ from 'lodash' 

??破解方法：??

bash复制
npm install lodash-es

然后改成：

javascript复制
import _ from 'lodash-es'

??阶段4：终极改造??
用这个神器转换老代码：

bash复制
npx cjs-to-es6 ./src

转换完记得检查特殊语法，比如??__dirname??这种全局变量要改成：

javascript复制
import { dirname } from 'path'
const __dirname = dirname(new URL(import.meta.url).pathname)

四、避坑指南（都是血泪教训）

??坑1：文件路径必须写全??

javascript复制
// 老写法能跑
const config = require('./config')

// 新写法必死
import config from './config' // ?

// 正确姿势
import config from './config.js' // ?

??坑2：循环依赖处理??
以前CommonJS能忍的循环引用，ES6直接报错！解决方案：

1. 重构代码结构
2. 用动态import补救：

javascript复制
// 在函数内部延迟加载
const getModule = async () => {
  const { func } = await import('./moduleA.js')
  return func()
}

我的私房经验（试错三年得出的结论）

最近帮朋友改造了个七年老项目，说点掏心窝子的话：??别追求一步到位！?? 混合使用阶段可能会持续3-6个月，这是正常现象。

??推荐迁移节奏：??

1. 每周改造2-3个核心文件
2. 每月做一次全量测试
3. 遇到第三方库不兼容？用??proxy大法??：

javascript复制
// esm-wrapper.js
import legacyModule from './legacy.cjs'
export default legacyModule

有次改到凌晨三点，发现个隐藏bug：老代码里用??module.parent??判断调用方，这在ESM里直接失效。最后用这个黑科技解决：

javascript复制
import { createRequire } from 'module'
const require = createRequire(import.meta.url)

最后说个行业真相：现在90%的npm包都支持ESM了，但总有那么几个钉子户。如果遇到死都不更新的库，别犹豫——直接fork源码自己改！毕竟时代在进步，咱们总不能被十年前的技术绑架一辈子吧？