通过四个关键步骤优化 Node.js 项目结构：先识别文件混乱与跨层引用等问题，再借助 AI 快速生成标准化分层骨架，随后将路由与业务逻辑迁移到 src 目录并完成控制器与服务层解耦，最后利用 .cursorrules 文件持续约束新结构，提升项目可维护性与扩展性。

当你在 Cursor 中打开一个 Node.js 项目时，如果发现文件分布杂乱、模块耦合严重、路由拆散且难以维护，想要快速梳理代码结构并搭建一个更适合长期迭代的项目骨架，就可以从下面这四个步骤入手。

识别当前结构缺陷

打开项目根目录，在侧边栏右键 → “Open in Terminal”，执行：find . -name "*.js" | head -20。如果输出结果中频繁出现index.js、app.js、server.js混杂在根目录，或者routes/目录下没有明确子目录划分，通常说明 Node.js 项目结构已经失去层次感——这正是后续重构和优化代码结构的起点，而不是单纯的报错问题。

再使用Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）→ 输入“Show Cursor Logs”，滚动查看最近10行内容，重点查找包含require(或import ... from且路径深度≤2的警告信息。这类日志往往能暴露跨层级直接引用的问题，例如routes/user.js直接require('../../utils/db')，这通常就是项目分层不清、解耦失败的典型信号。

用AI一键生成分层骨架

在任意空白 JS 文件中输入以下提示词，光标停留在末尾后按Tab：

【请为Express项目生成标准分层结构代码，包含：config/（环境变量、数据库连接）、src/（含controllers/、routes/、services/、models/、middleware/）、types/（TS定义，若启用）、.env.example。所有路径使用相对导入，禁止硬编码绝对路径。】

接受补全结果后，选中全部生成代码 → 右键 → “Move to Folder” → 新建文件夹refactor-skeleton。这一步不会覆盖原有文件，而是先生成一个可参考、可对照的标准模板，便于后续进行 Node.js 项目重构时逐项比对。

迁移与重定向旧逻辑

第一步：将原routes/目录下所有*.js文件剪切到新的src/routes/中，同时逐个打开文件，把顶部const router = express.Router();下方第一行调整为const { getUsers, createUser } = require('../controllers/user');（按实际函数名修改）。【不要继续保留原本指向../models或../utils的require路径，必须先迁移到src/controllers后再统一修改】

第二步：打开原有的app.js或server.js，删除所有类似app.use('/api/users', require('./routes/user'))的语句，替换为：

const userRoutes = require('./src/routes/user');
app.use('/api/users', userRoutes);

第三步：打开src/controllers/user.js，把原先写在路由处理器中的逻辑（例如function getUsers(req, res)）独立拆分出来，改造成更清晰的业务处理函数，例如exports.getUsers = async () => { /* 保留原有业务处理，但去掉req/res相关操作 */ }；随后新增src/services/userService.js，将数据库查询、写入等副作用操作统一迁移到服务层——【完成这一步后，控制器只负责参数校验和响应封装，真正访问数据库的职责应集中在服务层】

配置Cursor规则锁定新结构

在项目根目录创建.cursorrules文件，粘贴以下内容：

{
"rules": [
{"id": "no-root-js", "pattern": "^(?!src|config|types|\.env).*\.js$", "message": "禁止将JS文件直接放在项目根目录，应移至src/或config/目录"}
{"id": "route-controller-only", "pattern": "^src/routes/.*\.js$", "message": "src/routes/下的路由文件仅可require src/controllers/中的模块，不得直接连接models或services"}
{"id": "controller-no-db", "pattern": "^src/controllers/.*\.js$", "message": "src/controllers/下的控制器文件不得import或require数据库驱动、连接实例或SQL语句"}
]
}

保存后，当你尝试在src/routes/auth.js中编写const db = require('pg')这类代码时，Cursor 会实时提示报错。相比单纯依赖团队文档规范，这种方式对 Node.js 项目结构优化更有效——一旦结构写错，就能立即被拦截，避免问题继续扩散。