symfony 4 用 doctrine orm 的 migration 替代传统模型迁移，需先安装 doctrine/doctrine-migrations-bundle 并配置 bundles.php 和 doctrine_migrations.yaml；修改实体后运行 doctrine:migrations:diff 生成迁移文件，再执行 doctrine:migrations:migrate 同步数据库结构。
Symfony 4 不自带“模型迁移”概念——它用 Doctrine ORM 的 migration（数据库迁移）替代传统 MVC 中的 Model 层变更同步。所谓“执行模型迁移”，实际是指：根据实体类（Entity）结构变化，生成并执行数据库表结构变更脚本。Windows 和 Linux 下操作逻辑一致，差异仅在路径、权限和 Shell 行为，下面分关键环节说明。
确认 Doctrine Migrations 已安装并启用
Symfony 4 默认不预装 migrations 功能，需手动引入：
- 运行
composer require doctrine/doctrine-migrations-bundle - 检查
config/bundles.php中是否已启用：Doctrine\Bundle\MigrationsBundle\DoctrineMigrationsBundle::class => ['all' => true] - 确保
doctrine_migrations配置存在于config/packages/doctrine_migrations.yaml，且dir_name指向%kernel.project_dir%/migrations
基于实体变更生成迁移文件
修改 Entity 类（如 src/Entity/User.php）后，用以下命令生成差异迁移：
PyCharm 2026.2.0.1 Linux版
下载
PyCharm 2026.2.0.1 Linux版提供 JetBrains 官方 2026.2.0.1 版本安装包，适合需要指定 PyCharm 版本进行 Python 项目开发、运行和调试的用户。
- Windows（PowerShell 或 CMD）：
php bin/console doctrine:migrations:diff - Linux（Bash）：
php bin/console doctrine:migrations:diff - 若提示“no changes detected”，请确认已运行
php bin/console doctrine:schema:update --dump-sql验证实体与数据库是否真有差异 - 生成的迁移文件位于
migrations/Version*.php，内容含up()和down()方法
执行迁移（Windows 与 Linux 共同要点）
迁移执行本身跨平台一致，但要注意环境细节：
- 确保数据库服务正在运行（如 MySQL/MariaDB 或 PostgreSQL），且
.env中DATABASE_URL配置正确（Windows 路径无需转义，Linux 注意权限） - 执行迁移：
php bin/console doctrine:migrations:migrate - 首次运行时会自动创建
doctrine_migration_versions表来追踪状态 - Linux 下若遇权限错误（如写入 migrations 目录失败），运行
chmod -R 775 migrations/；Windows 一般无此问题，但需避免在 OneDrive 或受控文件夹中操作
常见失败场景与应对
跨平台都可能遇到，但表现略有不同：
- “Class not found” 错误：实体类命名空间或文件名大小写不匹配（Linux 对大小写敏感，Windows 不敏感；建议统一用标准 PascalCase 命名）
-
“Connection refused”：检查
DATABASE_URL中 host 是否为127.0.0.1（部分 Windows WSL 或 Docker 环境下localhost解析异常） -
迁移卡住或超时：大表添加索引或字段时，可先在数据库客户端手动执行 SQL，再用
--no-interaction跳过确认，并加--allow-no-migration避免空迁移报错
