直接用 composer require tecnickcom/tcpdf 安装即可，需先配置国内镜像（如阿里云：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/），安装后通过 vendor/autoload.php 自动加载，类名为 tcpdf（全大写）。
直接用 composer require tecnickcom/tcpdf 就能装，国内镜像只需提前配好，不用改安装命令。
配置国内 Composer 镜像（一次性操作）
不配镜像时，composer require 会从 packagist.org 拉包，国内直连慢甚至超时。配一次全局镜像，后续所有 require 都自动走国内源：
- 运行
composer config -g repo.packagist composer https://packagist.phpcomposer.com（旧版镜像，仍可用） - 或更推荐用阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 执行后可验证：
composer config -g repo.packagist应输出对应 URL
安装 TCPDF 的正确命令（无需额外参数）
镜像配好后，进项目根目录直接运行：
composer require tecnickcom/tcpdf
注意三点：
- 不要用
git clone+composer install—— 那是源码开发模式，普通项目用require更轻量 - 不要手动下载 ZIP 或复制文件夹 —— 自动加载、命名空间、依赖管理全靠 Composer
- 安装后类库路径固定在
vendor/tecnickcom/tcpdf/，autoload.php会自动加载
验证是否装成功（关键检查点）
写个最小测试脚本 test-tcpdf.php：
<?php require_once 'vendor/autoload.php'; $pdf = new \TCPDF(); var_dump(method_exists($pdf, 'AddPage')); // 应输出 bool(true) ?>
如果报错 Class 'TCPDF' not found，大概率是：
- 没运行
composer require，只配了镜像但没装包 - 脚本路径不对，
vendor/autoload.php路径错误（不是相对当前文件，而是相对执行位置） - 用了
tecnickcom/tcpdf但又手动 require 了旧版tcpdf.php，造成命名空间冲突
真正卡住的地方往往不是镜像速度，而是 autoload 加载失败或类名大小写混淆——TCPDF 必须全大写，tcpdf 小写会找不到类。
