VSCode中执行Flyway迁移需通过tasks.json调用本地CLI，而非插件；须确保PATH继承、flyway.conf路径正确、JDBC驱动显式加载，且SQLTools执行SQL文件需右键“Execute File”避免截断。
VSCode里让终端自动执行项目数据库迁移SQL，不是靠插件点几下就完事，而是得把任务、环境、权限三者对齐。最稳的路径是用 tasks.json 调本地 Flyway CLI，而不是依赖任何“一键迁移”插件——那些插件要么已停更，要么绕不开手动确认或路径错乱。
tasks.json 里怎么写 flyway migrate 才不报 command not found
VSCode 的终端默认不继承系统 PATH，尤其在 GUI 启动时。哪怕你在终端里能跑 flyway -v，任务里照样可能找不到命令。
- 显式写绝对路径：比如
/usr/local/bin/flyway或./mvnw flyway:migrate（若用 Maven wrapper） - 别指望
flyway.conf自动加载：它必须放在项目根目录，或通过-configFiles=参数显式指定 - Java 类路径问题：如果用 MySQL，
flyway.driver=org.mysql.jdbc.Driver不够，还得把mysql-connector-java-8.0.33.jar加进CLASSPATH或用-drivers=指向 JAR 路径 - 连接失败但参数没错？大概率是 JDBC 驱动没加载，或者数据库 URL 写成
jdbc:mysql://localhost:3306/db却忘了开远程访问权限
SQLTools 执行本地 .sql 文件时为什么只建表不插数据
SQLTools 的 “Run Current Query” 默认只执行光标所在 SQL 块，或当前选中内容；整文件执行需右键 → “Execute File”，否则遇到 ; 就停了，INSERT 语句根本没发出去。
- MySQL 的
DELIMITER语句在 SQLTools 里不被识别，存储过程创建会直接报错 - 文件含中文注释或 BOM 头？会导致语法解析失败，建议用 UTF-8 without BOM 保存
- 想批量执行多个 SQL 文件？不能靠右键，得写个 shell 脚本调
mysql -h 127.0.0.1 -P3306 -u root -p'pass' db_name ，再把脚本塞进 tasks.json
密码含 @ / / : 等字符时连接总失败
URL 中特殊字符未编码，JDBC 解析器会把 @ 当作用户名/主机分隔符，: 当作端口分隔符，直接截断。
- MySQL 连接串里密码必须 URL 编码：比如
pa@ss:w0rd→pa%40ss%3Aw0rd - VSCode 的 SQLTools 配置界面不自动编码，得手动改
.vscode/settings.json里的password字段 - 更安全的做法是用环境变量：
${env:DB_PASSWORD}，然后在终端启动 VSCode 前export DB_PASSWORD='pa@ss:w0rd'
真正卡住人的地方，往往不是语法或命令本身，而是环境变量继承、JDBC 驱动加载时机、以及 SQLTools 对多语句和分隔符的实际处理逻辑——这些细节不会报明确错误，只会静默失败或部分执行。
