CircleCI构建时未复制仓库隐藏文件，如何使其拷贝.env文件？

首先要明确核心原因：如果你的.env文件在仓库的.gitignore中，Git本身不会追踪这个文件，CircleCI的checkout步骤自然无法拉取到它——这也是管理敏感配置的正确姿势（敏感信息不该提交到代码仓库）。下面分两种场景给出解决方案：

场景1：.env在.gitignore中（推荐的敏感信息管理方式） #

方案A：用CircleCI环境变量替代.env文件 #

Node.js会自动读取process.env中的环境变量，不需要依赖物理的.env文件：

1. 登录CircleCI控制台，进入你的项目，点击「Project Settings」→「Environment Variables」。
2. 逐个添加.env里的键值对（比如DB_HOST=localhost、API_SECRET=xxx）。
3. 你的TypeScript代码直接通过process.env.DB_HOST这类方式读取变量即可，无需修改构建脚本。

如果你的代码必须依赖物理.env文件，可以在构建步骤中生成它：

- run:
    name: 生成.env文件
    command: |
      echo "DB_HOST=$DB_HOST" >> .env
      echo "API_SECRET=$API_SECRET" >> .env
      # 按需添加所有需要的环境变量

方案B：加密.env后提交到仓库 #

如果你一定要把.env文件和代码放在一起，先加密再提交：

1. 安装CircleCI CLI并加密文件：

   curl -fLSs https://circle.ci/cli | bash
   circleci env encrypt .env --repo 你的GitHub用户名/你的仓库名
   

2. 将加密后的.env.enc文件提交到仓库。
3. 在CircleCI配置中添加解密步骤（放在checkout之后）：

   - run:
       name: 解密.env文件
       command: circleci env decrypt .env.enc --repo 你的GitHub用户名/你的仓库名 -o .env
   

场景2：.env不在.gitignore中，但未被拉取 #

这种情况极少出现，可能是checkout步骤的默认行为异常，你可以替换为手动Git克隆来确保拉取所有文件：
把配置中的- checkout替换为：

- run:
    name: 克隆仓库并拉取所有文件
    command: |
      git clone $CIRCLE_REPOSITORY_URL ~/su-app-api
      cd ~/su-app-api
      git checkout $CIRCLE_SHA1

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