很多前端和全栈开发者在学习JavaScript后端开发时，都会遇到需要本地运行MySQL的情况。MySQL作为最流行的关系型数据库，配合Node.js使用非常广泛。本文将用最直白的方式，带你完成从下载安装到JavaScript代码连接的全流程，避开常见报错。
一、前期准备与安装包下载
首先打开MySQL官网，选择Community版本即可，这是免费开源的。根据你使用的操作系统下载对应安装包。Windows用户推荐下载zip归档包或msi安装程序，macOS用户可以直接用Homebrew命令拉取，Linux用户通过apt或yum源安装。下载后建议将文件放在非中文、无空格的路径下，避免后续权限报错。提前确认电脑已安装好Node.js基础环境，方便后续测试连接。
二、Windows系统安装详细步骤
如果使用msi安装器，一路点击下一步即可。关键步骤是在Server Configuration界面设置root账户密码，记住这个密码，后面JS连接必须用到。端口默认保持3306不要改，勾选以Windows服务运行并开机自启。安装完成后，打开命令行工具输入mysql -u root -p，提示符出现代表启动成功。如果习惯图形界面，可以额外安装MySQL Workbench辅助建表。Windows用户如果遇到找不到dll文件，请补装Visual C++运行库。
三、Mac与Linux环境快速部署
Mac用户直接在终端执行brew install mysql，等待自动编译下载。安装成功后运行brew services start mysql即可后台运行。Linux服务器用户通常使用sudo apt update && sudo apt install mysql-server这条命令。安装过程中会提示设置密码策略，按回车接受默认强度即可。配置环境变量后，同样用mysql命令测试连通性。Linux环境下记得检查防火墙是否放行了3306端口，否则远程工具连不上。
四、JavaScript连接数据库实战
数据库装好后，进入Node.js项目目录。推荐使用npm install mysql2命令安装官方维护的驱动，它支持Promise和async写法。新建一个db.js文件，引入模块后创建连接池。连接参数里填写host为localhost，user为root，password为你刚才设置的密码，database填你要操作的库名。连接成功后调用pool.getConnection获取实例，执行sql语句查询数据，最后务必调用connection.release归还连接，防止内存泄漏。这样你的JavaScript就能稳定读写MySQL数据了。
五、常见问题与避坑指南
新手最常遇到的是鉴权插件报错，新版MySQL默认使用caching_sha2_password，部分旧版框架不兼容。解决方法是登录数据库执行alter user命令修改认证方式为mysql_native_password。另一个高频问题是端口被占用，检查任务管理器或netstat命令，确保3306端口没被其他软件拦截。安全方面永远不要把数据库密码硬编码在前端页面，只放在后端环境变量中。按照这套流程走一遍，你的本地开发环境就能顺畅跑起来了。
