Laravel项目引入Bootstrap后异常及Git版本控制问题求助

我基于Laravel/Vagrant/Homestead环境开发项目，所有组件都是最新版本。原本项目运行正常，但引入Bootstrap 5.3后出现异常：

• 访问pcs2025.test能正常加载Jetstream的登录、仪表盘页面；
• 之前正常的pcs2025.test/positions页面，引入旧代码后Bootstrap样式消失，还原操作后直接变成白屏，无法加载；
• 现在测试基础的路由/控制器/Blade视图都无法正常启动。

另外，项目已经托管在Git，但我对版本控制操作不熟悉，回滚或重置时总是出问题，想知道怎么用版本控制避免这类问题。

附相关代码：

路由文件（自定义路由为最后一行） #

<?php

use Illuminate\Support\Facades\Route;

Route::get('/', function () {
    return view('welcome');
});

Route::middleware([
    'auth:sanctum',
    config('jetstream.auth_session'),
    'verified',
])->group(function () {
    Route::get('/dashboard', function () {
        return view('dashboard');
    })->name('dashboard');

    Route::get('/positions', 'App\Http\Controllers\PositionController@show')->name('positions.show');

});

PositionController #

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Models\Position;
use Illuminate\View\View;
use App\HPosition;
use App\Incumbent;
use Session;
use Auth;
use Illuminate\Support\Facades\Schema\columns;
use Illuminate\Support\Facades\DB;

class PositionController extends Controller
{
    public function show()
    {
        return view('positions.show')
            ->with('id', $id);
    }
}

Resources/Views/positions/show.blade.php #

<!doctype html>
<html lang="en">
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <meta name="csrf-token" content="{{ csrf_token() }}">
    <title>Bootstrap demo</title>
</head>
<body>
<h1>Hello, world!</h1>
</body>
</html>

一、先搞定页面白屏的代码问题 #

1. 控制器变量未定义
   PositionController的show方法直接使用了未声明的$id变量，触发致命错误导致白屏。修改控制器：

public function show()
{
    // 无需传递id的话，直接返回视图
    return view('positions.show');
    // 需要传递值的话，比如当前用户ID：
    // return view('positions.show')->with('id', Auth::id());
}

2. 错误的引入语句
   控制器里use Illuminate\Support\Facades\Schema\columns;这行是错误的，Schema的columns方法不需要单独引入，直接删除该行即可。如果需要获取表字段，可在方法内直接调用：

// 删除错误的use语句
$columns = Schema::getColumnListing((new Position)->getTable());

3. Bootstrap资源未引入
   当前Blade视图没有加载Bootstrap样式文件，所以样式不显示。添加CDN引用即可：

<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <meta name="csrf-token" content="{{ csrf_token() }}">
    <title>Bootstrap demo</title>
    <!-- 引入Bootstrap CSS -->
    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
</head>
<body>
<h1>Hello, world!</h1>
<!-- 需要交互组件的话，引入Bootstrap JS -->
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
</body>
</html>

如果是通过npm安装的Bootstrap，需通过Vite编译后引入对应的本地资源文件。

4. 开启调试模式查看具体错误
   将.env文件中的APP_DEBUG设置为true，白屏时会显示具体错误信息，方便快速定位问题。

二、Git版本控制的正确操作姿势 #

1. 日常提交规范

• 每次修改后用git status查看变更文件
• 用git add <文件名>或git add .暂存变更（确保.gitignore已排除.env、node_modules等无需提交的文件）
• 提交时写清晰的信息，比如fix: 修复PositionController未定义变量问题、feat: 引入Bootstrap 5.3样式

2. 安全回滚操作

• 回滚到上一个提交：git reset --hard HEAD^（注意：此操作会丢弃未提交的修改，确认后再执行）
• 查看历史提交记录：git log，找到目标提交哈希后执行git reset --hard <提交哈希>
• 仅撤销单个文件修改：git checkout -- <文件名>

3. 分支管理避免冲突

• 开发新功能/修改时创建独立分支：git checkout -b feature/bootstrap-integration
• 开发完成后合并到主分支：git checkout main → git merge feature/bootstrap-integration
• 合并冲突时，手动解决冲突后再提交

4. 定期同步远程仓库

• 本地修改提交后推送到远程：git push origin main
• 拉取远程代码前先提交本地变更：git pull origin main

内容的提问来源于stack exchange，提问作者Jeff Barefoot