cookiecutter 的 `cookiecutter.json` 是静态文件，不支持直接执行函数。可通过预处理脚本在运行 cookiecutter 前动态注入系统可用程序列表，实现运行时选择项生成。
在数据科学项目模板中，常需根据宿主系统已安装的外部工具（如 Python、R、CUDA 或特定 CLI 工具）提供版本选择。由于这些选项依赖运行环境且变化频繁，硬编码在 cookiecutter.json 中既不灵活也不可维护——而该文件本身又不支持表达式或函数调用（如 "program_version": ["generate_program_choices()"] 会被原样当作字符串处理，不会执行）。
✅ 正确做法：使用预生成脚本（pre-gen script） 动态更新配置文件。
步骤详解
-
编写 generate_program_choices.py（示例）
该脚本负责探测系统并返回合法选项列表（如已安装的 Python 版本）：
# generate_program_choices.py
import subprocess
import re
def get_python_versions():
try:
result = subprocess.run(["pyenv", "versions", "--bare"],
capture_output=True, text=True, check=True)
versions = [v.strip() for v in result.stdout.splitlines() if v.strip()]
# 过滤出语义化版本（如 3.9.18, 3.11.9）
return sorted(set(v for v in versions if re.match(r"^\d+\.\d+\.\d+$", v)))
except (subprocess.CalledProcessError, FileNotFoundError):
# 回退：尝试用 python --version + 系统查找
return ["3.9", "3.10", "3.11", "3.12"]
if __name__ == "__main__":
print("Available versions:", get_python_versions())
# 可选：直接输出供调试-
编写 update_choices.py（预处理主脚本）
在运行 cookiecutter 前执行，自动重写 cookiecutter.json：
# update_choices.py
import json
import sys
from pathlib import Path
# 导入你的探测逻辑（确保在 PYTHONPATH 中或同目录）
sys.path.insert(0, str(Path(__file__).parent))
from generate_program_choices import get_python_versions
# 读取并更新 cookiecutter.json
config_path = Path("cookiecutter.json")
with config_path.open(encoding="utf-8") as f:
config = json.load(f)
# 动态注入选项 —— 注意：必须是 list 类型，且元素为字符串
config["program_version"] = get_python_versions()
# 写回（保留格式与缩进）
with config_path.open("w", encoding="utf-8") as f:
json.dump(config, f, indent=4, ensure_ascii=False)
print(f"✅ Updated 'program_version' with {len(config['program_version'])} options.")-
执行流程（推荐封装为一键命令）
python update_choices.py && cookiecutter .
⚠️ 关键注意事项
- cookiecutter.json 中 "program_version" 字段值必须为字符串列表（如 ["3.11.9", "3.12.3"]），不可为函数引用或空值；
- 若模板被多人协作或 CI 使用，建议将 update_choices.py 加入 .gitignore 的生成产物（但脚本本身应纳入版本控制）；
- 如需更高阶控制（如条件跳过、交互式确认），可在脚本中加入 input() 或 argparse；
- 避免在 pre_gen_project.py 中修改 cookiecutter.json：该钩子在 cookiecutter 解析 JSON 之后 才运行，无法影响变量选择界面。
通过此方案，你既保持了 Cookiecutter 的声明式体验，又获得了运行时环境感知能力——简洁、可靠，且完全符合数据科学模板“一次生成、长期稳定”的设计目标。
