thinkphp项目中需将.env文件置于根目录、utf-8无bom编码、使用扁平键值对（如db_host=127.0.0.1），并在config/database.php中用env()函数引用变量，最后清缓存验证。
在ThinkPHP项目中实现数据库配置的环境变量隔离，是为了让开发、测试、生产三套环境共用同一份代码却各自使用独立的数据库连接参数，避免密码硬编码进config/database.php导致泄露风险。
确认.env文件位置与编码格式
把【.env文件必须放在项目根目录，与app、config、public同级】——放错位置（比如public/下或config/下）会导致ThinkPHP完全读不到它。
用VS Code或记事本新建文件，保存时选择UTF-8编码且【务必勾选“无BOM”选项】——带BOM的文件会被ThinkPHP 8静默忽略，不报错也不生效，排查起来极难定位。
文件名必须是.env，不能是.env.example或.env.bak，系统不会自动识别别名。
写入符合规范的数据库环境变量
在.env中逐行写入以下内容（等号两侧绝对不能有空格）：
DB_HOST=127.0.0.1
DB_PORT=3306
DB_NAME=myapp_dev
DB_USER=root
DB_PASS=123456
DB_PREFIX=tp_
注意：不要用[database]分段写法，ThinkPHP 8原生只认扁平键值对；若写成[database] DB_HOST=...，env('DB_HOST')将返回null，后续所有数据库操作都会失败。
敏感值如DB_PASS含特殊字符（@、$、#等）时，必须用双引号包裹：DB_PASS="p@ss#word!"。
修改config/database.php引用环境变量
打开config/database.php，找到'mysql'连接配置块内的'hostname'、'database'、'username'、'password'等字段，全部替换为env()函数调用：
第一步：将'hostname' => '127.0.0.1',改为'hostname' => env('DB_HOST', '127.0.0.1'),
第二步：将'database' => 'myapp_dev',改为'database' => env('DB_NAME', ''),
第三步：将'username' => 'root',改为'username' => env('DB_USER', 'root'),
第四步：将'password' => '123456',改为'password' => env('DB_PASS', ''),
第五步：确保'prefix' => env('DB_PREFIX', ''),这一行存在且第二个参数为空字符串——漏掉默认值会导致SQL生成nulluser这样的非法表名而直接报错。
清除缓存并验证环境变量是否加载成功
执行命令：php think optimize:config，这会清空runtime/config.php和runtime/cache/下的全部缓存。
在控制器里加一行测试代码：dump(env('DB_NAME'));，访问对应路由，应输出myapp_dev。
如果输出null或空字符串，说明.env未被读取，优先检查文件位置、编码、等号空格三个硬性条件。
再执行dump(Db::name('user')->getRealTableName());，输出tp_user表示前缀也已生效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
