嘿，这个场景太常见了——本地开发时端口被占，又不想动仓库里的核心配置，还怕误提交本地临时变更。给你几个官方推荐且实用的方案：

1. 使用Docker Compose的Override扩展文件（最推荐） #

Docker Compose天生支持扩展配置文件，默认会自动加载同目录下的docker-compose.override.yml，并将其配置与主docker-compose.yml合并，优先级更高。

步骤很简单：

• 在项目根目录新建docker-compose.override.yml，只写你需要覆盖的配置：

  version: '3.8'
  services:
    mysql:
      ports:
        - "3307:3306"  # 把本地端口改成未被占用的3307
  

• 将docker-compose.override.yml添加到你的.gitignore文件里，这样Git就不会追踪它，完全不用担心误提交。
• 正常运行docker-compose up -d即可，Compose会自动合并两个文件的配置。

这个方案的好处是：核心配置（docker-compose.yml）完全不动，本地专属配置隔离清晰，符合Docker官方最佳实践。

2. 用环境变量+本地.env文件隔离配置 #

把可变的配置项（比如端口）抽成环境变量，让主配置文件保持通用，本地用专属的env文件覆盖。

操作步骤：

• 修改主docker-compose.yml，把固定端口改成环境变量占位符：

  version: '3.8'
  services:
    mysql:
      ports:
        - "${MYSQL_LOCAL_PORT:-3306}:3306"  # 默认用3306，有环境变量则覆盖
  

• 新建.env.local文件，写入你的本地专属配置：

  MYSQL_LOCAL_PORT=3307
  

• 将.env.local添加到.gitignore，避免提交到仓库。
• 运行docker-compose up -d时，Compose会自动加载.env.local里的变量（如果你的Compose版本支持，或者可以通过--env-file参数指定：docker-compose --env-file .env.local up -d）。

这个方案适合需要动态调整多个配置项的场景，灵活性更高。

3. 临时命令行覆盖（适合单次临时调整） #

如果只是偶尔需要改端口，不想新建文件，可以直接在运行命令时通过-e参数指定环境变量：

docker-compose up -d -e MYSQL_LOCAL_PORT=3307

或者直接在命令行覆盖端口映射：

docker-compose run --publish 3307:3306 mysql

不过这种方式是临时的，每次运行都要手动指定，适合临时调试的场景。

内容的提问来源于stack exchange，提问作者Patrioticcow