TruncatedSVD仅接受scipy.sparse.spmatrix（如csr_matrix），若输入pandas.DataFrame或numpy.ndarray会悄默调用.toarray()致OOM；须用isinstance(X, scipy.sparse.spmatrix)严格校验，TfidfVectorizer输出默认合规。
TruncatedSVD 为什么不能直接喂 pandas.DataFrame 或 numpy.ndarray
它不会报错，但会悄悄调用 .toarray()，把百万列的稀疏表示转成全内存稠密数组——结果是进程卡死或 OOM。关键在于 TruncatedSVD 只接受 scipy.sparse.spmatrix，比如 csr_matrix 或 csc_matrix。
检查方式必须用：isinstance(X, scipy.sparse.spmatrix)，而不是看 shape 或 dtype。
- 常见来源如
TfidfVectorizer.fit_transform(docs)默认返回scipy.sparse.csr_matrix，可直传 - 若手头是
pd.DataFrame，别用.values；先确认是否真稀疏（非零占比 scipy.sparse.csr_matrix(df.values) - CSV/Parquet 数据：避免
pandas.read_csv().values→ 改用scipy.io.mmread()（Matrix Market 格式）或分块用HashingVectorizer
如何设置 n_components 才不崩也不浪费
n_components 设太高会触发 ArpackNoConvergence，设太低则丢失信息；它不是 PCA 那种“累计方差”可线性推算的指标，explained_variance_ratio_ 是近似值，仅作趋势参考。
- 安全上限参考：
min(1000, int(0.1 * min(X.shape)))，尤其当X.shape[1]≥ 10⁵ 时务必保守 - 实操路径：从
n_components=100开始，逐步加到 300，观察svd.explained_variance_ratio_增长是否明显放缓 - 底层依赖 ARPACK/LOBPCG，对维度敏感；
algorithm='arpack'确定性强但只适合小n_components（一般 ≤ 200）；algorithm='randomized'快但需固定random_state防止训练/推理漂移
transform 报错 ValueError: X has N features, but TruncatedSVD is expecting M features 怎么办
这不是数据问题，是特征空间没对齐。TruncatedSVD 对输入维度零容忍——训练时看到 100000 列，预测时哪怕少一列、多一列都直接炸。
立即学习“Python免费学习笔记（深入）”；
- 根本原因：新文档未复用训练时的
TfidfVectorizer.vocabulary_，或用了不同max_features/stop_words参数重新拟合 - 解决办法：保存并复用 fitted vectorizer，例如
joblib.dump(vectorizer, 'tfidf.pkl')，预测前先vectorizer.transform(new_docs) - 注意：即使词表一致，若用
dtype=np.float64训练、float32预测，某些旧版 scikit-learn 也会静默失败，统一用dtype=np.float32初始化更稳
降维后还是稀疏，但下游模型报 A sparse matrix was passed, but dense data is required
这是设计使然：TruncatedSVD.transform() 默认返回 scipy.sparse.csr_matrix，省内存、快计算，但并非所有模型都支持稀疏输入。
- 支持稀疏的模型（可跳过转换）：
LogisticRegression、SGDClassifier、LinearSVC - 不支持的模型（如
RandomForestClassifier）：必须显式转稠密，但X_reduced.toarray()可能再次爆内存 - 更稳妥做法：
np.ascontiguousarray(X_reduced.toarray(), dtype=np.float32)，同时限制n_components和 dtype 双重控内存 - 终极建议：用
sklearn.pipeline.Pipeline封装TruncatedSVD+ 模型，让 pipeline 自动处理中间格式流转
降维本身不难，难的是全程守住稀疏性边界——从输入检查、参数试探、特征对齐到下游适配，任何一环松动，都会在某个深夜让你面对一个安静卡住的 Python 进程和一行看不出错在哪的 warning。
