大型Node.js项目拆分后端代码时，node_modules存放及优化方案咨询

阿华AIGC实验室

2026-5-15

先给你明确结论：绝对不要把node_modules移到controllers文件夹，这会给你的大型项目埋下巨大的维护隐患，而且完全没有必要——Node.js本身的模块查找机制已经帮你解决了依赖引用的问题。

为什么不能移动node_modules？

Node.js的包管理工具（npm/yarn/pnpm）默认约定node_modules放在项目根目录，所有第三方依赖的安装、解析都是基于这个路径的。移动后，不仅当前controllers里的模块可能出现依赖问题，后续新增的任何子模块（比如models、routes）都会找不到依赖，而且npm install会自动在根目录重新生成node_modules，导致重复依赖、版本不一致，调试和协作都会变得一团糟。
大型项目通常会用到打包工具（如Webpack、Babel）、测试框架（如Jest）或部署脚本，这些工具默认读取根目录的node_modules，移动后你需要修改大量配置，成本极高且容易出错。
团队协作时，其他开发者按照标准流程npm install后，根目录还是会生成node_modules，你的自定义结构会导致团队成员的开发环境不一致，引发不必要的冲突。

正确的代码拆分方案（完全不需要动node_modules）

其实你完全误解了Node.js的模块查找机制：当你在子文件夹的模块中引用第三方包（比如require('express')）时，Node.js会自动向上遍历目录，直到找到项目根目录的node_modules。也就是说，只要根目录有node_modules，不管你的控制器在controllers文件夹还是更深的子目录，都能正常引用第三方依赖。

第一步：重构项目结构（适合大型项目）

推荐按功能/模块或职责拆分，而不是简单堆在controllers里，示例结构：

app
├─public
├─assets
├─node_modules
├─views
├─controllers       # 按业务拆分控制器
│  ├─user.js        # 用户相关逻辑
│  ├─order.js       # 订单相关逻辑
│  └─payment.js     # 支付相关逻辑
├─models            # 数据模型（如Mongoose/Schema定义）
│  ├─User.js
│  └─Order.js
├─routes            # 路由配置，把路由和控制器解耦
│  ├─userRoutes.js
│  └─orderRoutes.js
├─middleware        # 自定义中间件（如权限校验、日志）
│  ├─auth.js
│  └─logger.js
└─index.js          # 入口文件，只做初始化工作

第二步：模块引用示例

在index.js中引入路由/控制器：

const userRoutes = require('./routes/userRoutes');
const express = require('express');
const app = express();

app.use('/api/users', userRoutes);
// 其他初始化：连接数据库、启动服务器等

在routes/userRoutes.js中引入控制器：

const express = require('express');
const router = express.Router();
const userController = require('../controllers/user');

router.get('/profile', userController.getProfile);
router.post('/register', userController.register);

module.exports = router;

在controllers/user.js中直接引用第三方依赖：

const bcrypt = require('bcrypt'); // 自动从根目录node_modules查找
const User = require('../models/User');

exports.register = async (req, res) => {
  // 业务逻辑：加密密码、创建用户等
  const hashedPassword = await bcrypt.hash(req.body.password, 10);
  const user = new User({ email: req.body.email, password: hashedPassword });
  await user.save();
  res.status(201).json({ message: 'User created' });
};

大型项目的进阶代码管理建议

如果你的项目规模很大，还可以考虑以下优化：

使用ES Modules：在package.json中添加"type": "module"，改用import/export语法，比CommonJS的require更符合现代JS规范，也便于和前端代码统一。

按功能模块聚合：把相关的控制器、模型、路由、中间件放在同一个文件夹下，比如modules/user/，这样查找和维护业务逻辑更高效：

app
├─modules
│  ├─user
│  │  ├─controller.js
│  │  ├─model.js
│  │  ├─routes.js
│  │  └─middleware.js
│  └─order
│     ├─controller.js
│     └─routes.js
└─...