源码下载后配置环境报错多因本地运行条件不匹配，需先定位错误类型：确认php版本（ci3需5.6+、ci4需7.3+且推荐8.0+）、必要扩展（如intl、mbstring、pdo等）、base_url与实际路径一致、url重写规则生效（apache启用mod_rewrite并配置.htaccess，nginx设置try_files），并检查数据库配置、错误显示开关及目录写入权限。
源码下载后配置环境报错，多数不是代码本身的问题，而是本地运行条件没对齐。关键要分清是PHP版本、路径设置、重写规则还是权限问题——先定位错误类型，再针对性解决。
确认PHP版本和扩展是否匹配
CodeIgniter 3要求PHP 5.6+，CI4最低需PHP 7.3+（推荐8.0+）。很多报错如“Class not found”或空白页，根源常是PHP版本过低或缺失必要扩展：
- 运行
php -v和php -m | grep -E "(pdo|mbstring|openssl)"检查版本与扩展 - CI4必须启用
intl、json、mbstring；CI3还需mysqlnd或mysqli - 若用XAMPP/WAMP/MAMP，注意它们自带的PHP版本可能较旧，建议手动升级或换用Laragon、Docker等现代环境
检查base_url和index_page设置是否一致
访问首页显示404、资源加载失败或CSS/JS 404，大概率是base_url和服务器入口路径不匹配：
- CI3：打开
application/config/config.php，设$config['base_url'] = 'http://localhost/your-project/';，且$config['index_page'] = '';（清空后才启用重写） - CI4：改
.env文件，确保app.baseURL = "http://localhost/your-project/"，并取消注释；同时确认CI_ENVIRONMENT = development - 注意：URL末尾斜杠不能少，路径必须和实际Web根目录下项目所在位置完全一致
验证URL重写是否生效
能打开index.php/welcome但打不开/welcome，说明重写规则没起作用：
- Apache：确认
.htaccess文件存在且在项目根目录（CI3）或public/目录（CI4），内容含RewriteEngine On及正确规则；同时检查Apache是否启用mod_rewrite，且AllowOverride All已配置在虚拟主机中 - Nginx：直接修改server块，加入
try_files $uri $uri/ /index.php?$query_string;，root指向public（CI4）或项目根（CI3） - CI4用户可先用
php spark serve绕过重写问题，快速验证框架是否跑通
排查常见配置陷阱
有些错误看似随机，实则由细节疏忽导致：
-
数据库连接失败：检查
application/config/database.php（CI3）或.env中的database.default.hostname等字段是否填全，密码含特殊字符需URL编码 -
空白页无报错：CI4默认关闭错误显示，务必设
CI_ENVIRONMENT = development；CI3检查index.php顶部error_reporting(E_ALL); ini_set('display_errors', 1);是否开启 -
目录权限问题：Linux下确保
writable/（CI3）或writable/与cache/（CI4）有写入权限：chmod -R 755 writable/
