如何在Git发布版本中忽略指定文件？Nette项目核心开发场景

遇到这种需求太常见了，我给你分享几个在PHP/Nette项目里常用的最佳实践，既能让团队共享测试文件，又不会把它们带到生产发布包中：

1. 利用Git的export-ignore属性 #

这是最直接的Git原生方案，完美匹配你的需求：

• 操作步骤：在项目根目录创建.gitattributes文件，添加针对测试启动文件/目录的规则，比如：

  /bootstrap-dev.php export-ignore
  /dev-demo/ export-ignore
  /local-config.neon export-ignore
  

• 原理：当你用git archive生成发布包（很多打包工具、Composer默认都会依赖这个命令）时，标记了export-ignore的内容会被自动排除，但它们仍然会保留在Git仓库中，同事拉取代码时能正常获取并使用这些测试文件。
• 优势：无需额外工具，完全不影响日常开发流程，Git层面就能精准控制发布内容。

2. 把测试文件归类到独立目录，通过Composer配置排除 #

如果你的核心模块是通过Composer发布的，这个方法更贴合PHP生态规范：

• 操作步骤：把所有独立启动、测试用的文件统一放到demo/或dev-tools/目录下，然后在composer.json中添加排除规则：

  "extra": {
    "exclude-from-dist": [
      "/demo",
      "/dev-tools",
      "/local-test-setup.php"
    ]
  }
  

• 原理：Composer在执行composer archive生成发布包，或者通过Packagist分发时，会自动跳过这些指定的目录/文件，确保用户安装的正式包不包含测试内容。
• 优势：符合PHP库的发布规范，和Composer生态无缝衔接。

3. 通过环境变量控制测试文件加载（辅助方案） #

如果需要临时保留文件但确保生产环境不执行，可以配合环境判断：

• 操作步骤：在核心模块的入口逻辑中加入环境判断：

  // 核心模块入口文件
  $env = getenv('APP_ENV') ?? $_SERVER['APP_ENV'] ?? 'prod';
  if ($env === 'dev') {
      // 仅开发环境加载测试启动文件
      require __DIR__ . '/bootstrap-dev.php';
  } else {
      // 生产环境执行正式逻辑
      require __DIR__ . '/bootstrap-prod.php';
  }
  

• 原理：即使测试文件不小心被包含在发布包中，只要生产环境的APP_ENV设置为prod，就不会执行测试代码。不过更推荐结合前两种方法彻底排除文件，避免冗余。
• 优势：快速灵活，适合临时测试场景，配合Nette的环境配置系统使用体验更好。

如果是Nette项目，可以把测试用的配置文件（比如dev.neon、local.neon）也加入排除规则，同时在测试启动文件中指定加载这些配置，这样团队成员能快速搭建本地测试环境，又不会把本地配置带到生产包中。

内容的提问来源于stack exchange，提问作者Martin Pohorský