环境准备与项目初始化
在使用npm安装mysql之前，必须先确认本地已经具备Node.js运行环境。打开命令行工具或终端，输入node -v命令检查版本。只要显示v14及以上的版本号，就代表环境合格。若未安装，前往官网下载长期支持版，安装时保持默认选项即可。接着在磁盘任意位置新建一个空白文件夹，例如命名为mydb-test。在命令行中使用cd命令切换至该文件夹路径，然后执行npm init -y。这条指令会自动生成package.json配置文件，它负责记录项目的所有依赖项，是后续管理的核心枢纽。
执行npm安装命令
项目骨架搭建完毕后，即可开始安装数据库驱动。在终端中输入npm install mysql --save并按回车键。此处安装的mysql属于经典稳定版，适用于绝大多数传统后端项目。如果你的项目基于TypeScript构建，或者希望获得更流畅的Promise语法体验，推荐改用npm install mysql2 --save命令进行安装。命令执行后，终端会滚动显示依赖解析与下载进度。当界面不再输出红色警告且出现绿色对勾标识时，表示安装已完成。
此时返回项目根目录，你会看到新生成的node_modules隐藏文件夹与package-lock.json锁文件。打开package.json文件，翻至dependencies节点，会发现mysql及其版本号已被自动写入。这证明依赖已成功绑定至项目。为了直观验证安装状态，你可以尝试在终端输入npm list mysql，系统会返回该包的精确版本信息，以此确认没有安装失败或版本冲突。
编写连接代码与本地测试
驱动就位后，需要编写实际代码来打通数据通道。在当前目录新建app.js文件，使用任意代码编辑器打开。首先在首行添加const mysql = require('mysql')语句加载模块。随后定义连接配置对象，其中host通常填写127.0.0.1，user默认为root，password替换为你自定义的数据库登录密码，database填入目标库名。配置对象准备好后，调用mysql.createConnection(config)创建连接实例。
建立连接需调用instance.connect()方法。为规避网络波动导致的程序中断，建议在connect回调中加入err判断。若err为空，则说明握手成功，可继续执行instance.query('SELECT 1', callback)进行连通性探测。查询返回后，调用instance.end()释放资源。保存文件后，在终端运行node app.js。控制台若打印出null及查询结果数组，即代表npm安装的mysql已完美运行。若提示ECONNREFUSED，请检查操作系统后台的MySQL服务是否处于开启状态，以及3306端口是否被安全软件拦截。
高频故障排查与优化技巧
新手阶段最常碰壁的是权限拒绝问题。非root账户访问特定库时，需在MySQL客户端内执行授权语句，例如grant select,insert,update,delete on test_db.* to 'dev_user'@'localhost' identified by '123456'。刷新权限后重新连接即可。其次是中文乱码现象，根源在于字符集不统一。在连接参数中追加charset: 'utf8mb4'，并在连接成功后立即执行SET NAMES utf8mb4指令，能从根本上消除问号乱码。
生产环境中单连接无法满足并发需求，必须引入连接池机制。将createConnection替换为createPool方法，传入相同配置对象。连接池会自动维护一组活动连接，业务请求到来时直接分配空闲连接，处理完毕后归还池中。这种方式能将数据库吞吐量提升数倍。另外，强烈建议将密码等敏感字段抽取至.env环境变量文件中，借助dotenv模块读取，切勿将明文密码写在js源码里，以防代码入库后引发泄露风险。
总结与后续开发建议
整套流程走完，你已经独立完成了从环境校验、依赖下载到代码联调的全部动作。npm安装mysql的核心逻辑并不复杂，关键在于理解配置参数的含义与生命周期管理。初期练习时，可结合图形化工具如Navicat或DBeaver同步观察数据变化，加深理解。随着功能迭代，逐步将SQL查询封装为独立函数，配合路由层实现模块化调用。保持定期执行npm audit检查安全漏洞，及时升级补丁，你的数据库交互层就能稳定支撑各类业务场景。
