VSCode集成终端执行特定数据库迁移指令-VSCode-PHP中文网

vscode中执行flyway迁移需通过终端调用cli而非插件，关键在于确保flyway命令可达、flyway.conf置于项目根目录、sql脚本命名严格遵循vx.y.z__desc.sql规范，并以工作区根目录为路径基准。

vscode集成终端执行特定数据库迁移指令

VSCode集成终端能直接执行数据库迁移命令，但必须绕开“插件幻想”——它不自动识别你项目里装了Flyway或Liquibase，也不会读application.yml里的配置。真正起作用的是你在终端里敲的那条命令，以及它背后依赖的环境是否就绪。

这不是VSCode的问题，而是你的shell没找到flyway可执行文件。

先在系统任意终端（非VSCode）运行flyway -v，确认能输出版本号；如果不行，说明CLI没装或没加进PATH
VSCode集成终端默认继承系统PATH，但某些Linux桌面环境或macOS的GUI启动方式会导致PATH不完整——此时需在settings.json里显式设置："terminal.integrated.env.linux": { "PATH": "/usr/local/bin:/opt/homebrew/bin:${env:PATH}" }
若用Maven wrapper，别写flyway migrate，改用./mvnw flyway:migrate，并确保mvnw有执行权限（chmod +x ./mvnw）

常见原因是JDBC驱动不在classpath，或者flyway.conf没被正确加载。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

flyway CLI默认只读项目根目录下的flyway.conf，不会扫描src/main/resources/；把配置文件放到项目顶层，或用-c参数显式指定路径：flyway -c=./config/flyway.conf migrate
PostgreSQL用户常漏掉flyway.locations，导致SQL脚本根本没被扫描——检查flyway.conf里是否有flyway.locations=filesystem:src/main/resources/db/migration
MySQL连接URL要写全：flyway.url=jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=UTC，注意&是XML/JSON转义，终端里实际要用&（单个符号），否则解析失败

Flyway靠文件名排序，不是按修改时间，也不是按字母顺序随便排。

命名必须严格匹配V<major>.<minor>.<patch>__<description>.sql</description></patch></minor></major>，例如V1.0.0__init.sql、V1.0.1__add_user_table.sql；中间两个下划线__不能少，也不能多
不要用V1或V1.0这种简写——Flyway会把它当V1.0.0，但后续V1.0.1可能被忽略
如果脚本里含DELIMITER（如MySQL存储过程），Flyway默认不支持；得在flyway.conf里加flyway.sqlMigrationSeparator=GO，再把分隔符改成GO