如何在GitLab CI中让导入的公共库模板调用自有脚本，无需在各项目重复添加脚本文件？

这个问题其实是GitLab CI模板复用里非常常见的资源路径痛点——总不能每个引用模板的项目都复制一遍脚本吧？咱可以用这几个方案解决，按推荐度排序：

方案1：直接用GitLab CI的include内置路径（最省心，无额外操作） #

当你通过include导入公共库的文件时，GitLab会自动把整个公共库的内容下载到CI环境的特定目录，路径格式是：
${CI_PROJECT_DIR}/.gitlab-ci/include/<公共库完整项目路径>/<引用的分支/tag>/

假设你的extractText.js在common-library的根目录，那直接修改公共库中templates/gitlab-ci.yml的after_script部分：

after_script:
  - export Text=$(node "${CI_PROJECT_DIR}/.gitlab-ci/include/common-library/branch-123/extractText.js")

要是脚本在公共库的templates目录下，路径就改成：
${CI_PROJECT_DIR}/.gitlab-ci/include/common-library/branch-123/templates/extractText.js

小贴士：如果用固定tag替代分支，路径会更稳定，避免分支更新导致路径失效。

方案2：在CI模板里主动克隆公共库（灵活度更高） #

要是担心include的路径不够可靠，或者需要随时拉取最新脚本，可以在CI流程最开始加个预步骤克隆公共库：

修改公共库的templates/gitlab-ci.yml：

# 新增一个预阶段，专门拉取公共库脚本
fetch_common_scripts:
  stage: .pre
  script:
    - git clone --branch branch-123 https://gitlab.example.com/common-library.git common-lib
  artifacts:
    paths:
      - common-lib/
    expire_in: 1 hour

# 然后在test阶段调用脚本
test:
  stage: test
  before_script:
    - npm ci
  script:
    - npm test
  after_script:
    - export Text=$(node common-lib/extractText.js)
  dependencies:
    - fetch_common_scripts

这个方法的好处是路径直观，而且只要公共库分支更新，所有引用模板的项目都会自动用上最新脚本，不用改路径。

方案3：把脚本打包成npm包（最规范，适合长期维护） #

如果这个脚本功能复杂、需要迭代版本，做成私有npm包是最专业的选择：

1. 在common-library里把extractText.js封装成npm包，比如叫@your-org/extract-text，在package.json里配置bin字段：

{
  "name": "@your-org/extract-text",
  "version": "1.0.0",
  "bin": {
    "extract-text": "./extractText.js"
  }
}

2. 把包发布到你的私有npm仓库（比如GitLab自带的Registry）。

3. 修改公共库的CI模板，让项目安装后直接调用命令：

test:
  stage: test
  before_script:
    - npm ci
    - npm install @your-org/extract-text --save-dev
  script:
    - npm test
  after_script:
    - export Text=$(npx extract-text)

这样每个项目只要配置好私有仓库的访问权限，就能直接用脚本，不用复制文件，还能通过版本号精准控制脚本版本。

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