ThinkPHP文件重命名核心是避免覆盖、安全风险及跨平台大小写问题，分三类：上传文件需闭包生成唯一名并禁用自动重命名；控制器/模型须严格PSR-4规范，PascalCase命名且路径匹配；模板统一小写加连字符。
ThinkPHP 文件重命名核心目标是避免同名覆盖、防止安全风险、适配跨平台大小写差异。关键不在“怎么改名”，而在于“谁来改、何时改、按什么规则改”。下面分三类常见场景说明实用做法。
上传文件重命名：必须手动干预，不能依赖默认
ThinkPHP 默认上传后会用哈希重命名（如 5f8a1b2c3d4e5f6a7b8c9d0e1f2a3b4c.jpg），但业务中常需保留语义或兼容旧系统。此时要主动设置 saveName：
- TP8 只接受字符串或闭包，数组写法（如
['uniqid', '']）已失效； - 推荐闭包方式，确保高并发不重复：
$upload->saveName = function($file) {<br> return uniqid() . '_' . time() . '.' . strtolower($file->getOriginalExtension());<br>}; - 注意：
move()的第三个参数必须设为false，否则你传的名称会被忽略； - 中文文件名直接拼接会失败，建议弃用原名，或用
urlencode()或拼音库转义后再参与命名。
控制器/模型类文件重命名：保持命名空间与路径严格一致
这类重命名不是为防冲突，而是为符合 PSR-4 自动加载规范，否则 Linux 下直接报错（Windows 不敏感但上线即崩）：
- 文件名必须 PascalCase，且与类名完全一致：如
UserLogin.php→ 类必须是class UserLogin； - 命名空间要匹配路径：文件在
app/controller/UserLogin.php，命名空间就得是app\controller； - 别用小写文件名（如
user.php）或驼峰混写（如userModel.php），这些在 Linux 下无法自动加载； - 批量检查可用命令：
find . -path "./app/*" -name "*.php" | grep -E "(/[a-z]+\.php$|/[a-z][a-z0-9]*[A-Z][a-zA-Z0-9]*\.php$)"，定位不合规文件。
模板文件重命名：统一小写+连字符，避免大小写引用出错
模板路径不区分大小写是开发时的假象，Linux 服务器上 {include file="Public/Header"} 会找不到 public/header.html：
立即学习“PHP免费学习笔记（深入）”；
- 所有模板目录名（
index、admin、public）全小写； - 所有模板文件名也全小写，用连字符分隔单词：
user_profile.html，不用UserProfile.html； - 模板中引用统一小写：
{include file="public/header"}，不要大写首字母或驼峰； - 若必须保留语义，可在
config/template.php中显式指定'view_path'，但不如统一命名来得可靠。
