如何在Node.js中高效管理大量MySQL查询字符串？

以下是几种比手动用fs读取更省心的方案，直接适配你的场景：

1. JS模块直接导出（最简便无额外成本） #

直接新建一个queries.js文件，把所有SQL查询作为常量导出，完全不需要文件读取操作，业务代码直接导入使用：

// queries.js
exports.createUser = "INSERT INTO users(`firstname`,`lastname`,`email`,`password`) VALUES(?)";
exports.checkRegister = "SELECT * FROM users WHERE email = ?";
// 其他查询直接追加即可

在业务文件里直接调用：

// 业务逻辑文件
const queries = require('./queries');
// ES模块环境用：import queries from './queries.js';

// 使用示例
db.query(queries.createUser, [firstname, lastname, email, hashedPassword], (err, result) => {
  // 处理逻辑
});

这个方案的优势是零额外依赖，编辑器还能提供语法提示，维护时直接找对应的常量修改即可。

2. JSON文件存储（适合纯SQL场景） #

如果不想写JS语法，新建queries.json把查询存成键值对：

{
  "createUser": "INSERT INTO users(`firstname`,`lastname`,`email`,`password`) VALUES(?)",
  "checkRegister": "SELECT * FROM users WHERE email = ?"
}

Node.js会自动解析JSON文件，直接require就能用：

const queries = require('./queries.json');
// 直接使用 queries.checkRegister

注意：JSON里的字符串不能有未转义的双引号，你的查询用反引号包裹字段名完全没问题。

3. 独立SQL文件+一次性加载（适合复杂带注释的SQL） #

如果你的SQL语句很长、带注释，建议按功能拆分到独立的.sql文件中，比如建一个sql/目录：

-- sql/createUser.sql
INSERT INTO users(`firstname`,`lastname`,`email`,`password`) VALUES(?)

-- sql/checkRegister.sql
SELECT * FROM users WHERE email = ?

然后写一次工具函数自动加载所有SQL文件，避免重复写fs逻辑：

// sqlLoader.js
const fs = require('fs');
const path = require('path');

const loadQueries = () => {
  const sqlDir = path.join(__dirname, 'sql');
  const sqlFiles = fs.readdirSync(sqlDir).filter(file => file.endsWith('.sql'));
  const queries = {};
  
  sqlFiles.forEach(file => {
    const queryName = file.replace('.sql', '');
    // 读取并去掉多余的换行和空格
    queries[queryName] = fs.readFileSync(path.join(sqlDir, file), 'utf8').trim();
  });
  
  return queries;
};

module.exports = loadQueries();

之后业务代码直接导入这个工具的结果：

const queries = require('./sqlLoader');
// 使用 queries.createUser

这个方案适合SQL复杂度高的场景，每个查询独立文件可读性更强，新增查询只需要加.sql文件，不用修改加载逻辑。

额外提醒 #

• 不管用哪种方案，都要坚持用参数占位符（?），绝对不要直接拼接变量到SQL中，防止SQL注入
• 如果用TypeScript，可以给查询定义联合类型，增强类型校验，比如type QueryKey = 'createUser' | 'checkRegister'

内容的提问来源于stack exchange，提问作者user20345646