Ray Tune 比 GridSearchCV 更适合超参搜索，因其天然支持异构资源调度、自动容错、早停和可视化；而 GridSearchCV 默认单进程、绑定 sklearn 框架，无法跨节点扩展，模型训练耗时或超参组合多时易卡死或内存溢出。
Ray Tune 为什么比 GridSearchCV 更适合超参搜索
因为 GridSearchCV 默认单进程、锁死在 sklearn 框架内，无法跨机器调度；而 Ray Tune 天然支持异构资源（CPU/GPU/多节点）、自动容错、早停和结果可视化。如果你的模型训练一次要 2 分钟以上，或者想同时跑 50+ 组超参，GridSearchCV 会卡死或 OOM，Ray Tune 才是实际可用的选择。
常见错误现象：ray.init() 报 ConnectionError 或 redis.exceptions.ConnectionError —— 这通常是因为没关掉已有 Ray 集群（比如 Jupyter 里反复运行 ray.init()），或 Docker 容器没暴露 Redis 端口。解决办法是每次启动前加 ray.shutdown()，或显式指定地址：ray.init(address="auto", ignore_reinit_error=True)。
如何写一个可被 Ray Tune 调度的训练函数
核心约束：函数必须接收一个 config 字典作为唯一参数，并调用 tune.report() 上报指标。不能直接 print，不能依赖全局变量，不能在函数外读文件路径（除非用 tune.with_parameters() 封装）。
-
config里所有键都会被 Ray 自动采样（用tune.grid_search、tune.loguniform等定义） - 训练逻辑里别用
sklearn.model_selection.train_test_split(random_state=42)这种固定 seed —— 每个 trial 是独立进程，seed 冲突会导致结果不可复现；应改用random_state=config.get("seed", 42) - GPU 使用需显式声明：
resources_per_trial={"gpu": 1}，且函数内用torch.cuda.set_device(0)或tf.config.set_visible_devices(gpus[0], "GPU")
示例最小可运行结构：
立即学习“Python免费学习笔记（深入）”；
def train_fn(config):
model = RandomForestClassifier(
n_estimators=config["n_estimators"],
max_depth=config["max_depth"]
)
model.fit(X_train, y_train)
acc = model.score(X_val, y_val)
tune.report(accuracy=acc) # ← 必须用 tune.report，不是 return怎么设置搜索空间和调度策略不踩坑
搜索空间写错是导致搜索“看似在跑但结果全一样”的最常见原因。比如误写 n_estimators=tune.choice([10, 50]) 却在训练函数里写成 config.n_estimators（实际是 config["n_estimators"]）；或把 tune.uniform(0.001, 0.1) 当成对数尺度用（它其实是线性均匀，该用 tune.loguniform(1e-3, 1e-1)）。
调度策略选错会让资源浪费严重：
- 简单暴力搜？用
ASHAScheduler(metric="accuracy", mode="max", grace_period=5)，它会在 early stage 就淘汰差的 trial - 有历史数据或想加速收敛？加
search_alg=HyperOptSearch()，但注意 HyperOpt 不原生支持条件搜索（如 “当 model==x 时才搜 learning_rate”），得用tune.sample_from()匿名函数绕过 - 别漏掉
num_samples=20—— 这才是真正控制 trial 总数的参数，max_concurrent=4只控制并发量
如何加载已有 checkpoint 继续搜索或分析结果
Ray Tune 默认把每个 trial 的 checkpoint 存在本地 ~/ray_results/ 下子目录里，但路径名含时间戳和随机字符串，手动找很麻烦。正确做法是启动时指定 name="my_exp" 和 local_dir="./tune_results"，再用 tune.ExperimentAnalysis() 加载：
analysis = tune.ExperimentAnalysis(
experiment_dir="./tune_results/my_exp"
)
print(analysis.get_best_config(metric="accuracy", mode="max"))容易忽略的点：
- checkpoint 默认只存模型权重（如果训练函数里调用了
train.save_checkpoint()），不存完整 pipeline 或预处理对象 —— 所以恢复后仍需重新 fit scaler/encoder - 如果搜索中途被 kill，只要没删
local_dir，下次用同样name和resume="AUTO"就能续跑，但注意 resume 会跳过已成功完成的 trial，不会重复计算 -
analysis.trials是 list，每个元素是Trial对象，其.last_result字典里才有你tune.report()的所有字段
超参搜索真正的复杂点不在写几行代码，而在设计搜索空间时对模型行为的理解——比如 learning_rate 和 batch_size 的耦合效应，或者 tree-based 模型中 max_depth 和 min_samples_split 的相互制约。Ray 提供了调度能力，但没法替你判断哪些维度值得搜、哪些该固定。
