source 命令仅限 MySQL 客户端内使用，须先登录再执行绝对或相对路径的 source /path/to/file.sql；常见失败原因包括路径错误、权限不足和字符集不匹配；推荐脚本中用 mysql -u root -p db_name

source 命令只能在 MySQL 客户端内使用，不能在系统 shell 里运行

很多人输完 mysql -u root -p 进去后，直接在终端敲 source /path/to/file.sql，结果报错 ERROR 1064 (42000) 或提示 “Unknown command”。这是因为 source 是 MySQL 客户端的内置命令，不是 shell 命令，必须先登录进 MySQL 才能用。

正确流程是：

• 先执行 mysql -u root -p 登录 MySQL 客户端
• 再输入 source /path/to/file.sql（路径必须是绝对路径或相对于当前 MySQL 客户端启动目录的相对路径）
• 注意末尾要加英文分号 ; 吗？不用 —— source 是客户端命令，不接受分号

文件路径写错、权限不足、字符集不匹配是三大高频失败原因

即使 source 语法对了，也常卡在这三类问题上：

• /path/to/file.sql 如果是相对路径，它基于的是你启动 mysql 命令时所在的 shell 目录，不是 MySQL 安装目录，也不是用户家目录
• MySQL 客户端读取文件依赖当前运行用户的文件读取权限；如果文件属主是 root，而你是用普通用户登录的 MySQL，可能报 Failed to open file
• SQL 文件含中文或特殊符号时，若文件编码是 UTF-8 BOM 或 GBK，而 MySQL 默认连接字符集是 latin1，会导致乱码甚至语法错误；建议提前在客户端里执行 SET NAMES utf8mb4; 再 source

替代方案：mysql 命令行直接重定向执行，更稳定且适合脚本

比起交互式 source，多数自动化场景下推荐用 shell 层直接导入：

kashen-mysql DDLtoExcel

解析 MySQL 8.0 的 DDL 脚本，并将表结构导出为 Excel 格式。适用于用户需将 MySQL 的 `CREATE TABLE` 语句转换为结构化的 Excel 文件场景，导出内容包含字段名、数据类型、长度及精度等信息。支持多张表的批量处理，每张表对应 Excel 中的一个独立工作表。适用于数据库文档编写、数据字典生成及模式分析等任务。

下载

• 执行 mysql -u root -p database_name —— 注意这里是 shell 的 重定向，不是 MySQL 里的命令
• 该方式自动使用当前 shell 的字符编码，且绕过 MySQL 客户端对路径的限制；但要求 SQL 文件开头不能有 USE database_name;，否则会和命令行指定的库冲突
• 如需指定字符集，加 --default-character-set=utf8mb4 参数，例如：mysql -u root -p --default-character-set=utf8mb4 mydb

执行失败时怎么快速定位问题

source 出错默认只报第一处语法错误位置，很难知道具体哪一行坏了：

• 先用 head -n 20 /path/to/file.sql 看开头有没有 BOM、注释格式异常（比如 /* */ 跨太多行）、或意外的 shell 变量（如 $DB_NAME）残留
• 用 mysql -u root -p -e "source /path/to/file.sql" 2>&1 | head -n 10 把错误输出截断查看，避免刷屏
• 最稳妥的是把大 SQL 拆成小段，用 sed -n '1,50p' file.sql | mysql -u root -p db 分批试，尤其当文件含 CREATE PROCEDURE 或自定义 delimiter 时

真正麻烦的不是不会用 source，而是它不报错就停在某一行——比如遇到空行、注释末尾少个换行、或者某个 DELIMITER 没配对，整个后续都静默跳过。动手前先用 mysql --verbose -u root -p -e "source /path/to/file.sql" 开启详细模式，能看到每条语句实际执行了什么。