gf 一键跳转：dotfiles 中 vim-projectionist 的 Laravel 源码与测试文件映射实战

gf 一键跳转dotfiles 中 vim-projectionist 的 Laravel 源码与测试文件映射实战【免费下载链接】dotfiles$HOME sweet $HOME项目地址: https://gitcode.com/gh_mirrors/dotfiles53/dotfilesdotfiles 是一个$HOME sweet $HOME的个人配置文件集其中 Neovim 配置通过vim-projectionist 插件为 Laravel 项目定义了源码 ↔ 测试文件的路径映射规则配合gf快捷键实现一键跳转在控制器上按一下直接飞到对应测试测试不存在时还会自动创建。本文带你完整看懂这套映射实战。为什么需要 gf 一键跳转在 Laravel 项目中你每天都在做这些事写完app/Http/Controllers/OrderController.php手动在tests/Feature/里找OrderControllerTest.php改了测试报错再翻回源码目录逐层定位测试文件根本还没建得先手动touch一个空文件。vim-projectionist的作用就是让编辑器认识你的项目结构用一套 glob 规则告诉它哪类文件是源码、哪类文件是测试、它们之间怎么对应。之后你只需用鼠标点一下文件路径按gfvim 里意为go to file编辑器就会按规则算出目标文件路径文件存在 → 直接打开文件不存在 →自动创建新文件让你马上开写。核心配置projectionist.lua 里的映射规则所有映射规则集中在 nvim/lua/user/plugins/projectionist.lua 中。以 Laravel 项目检测到根目录有artisan文件时生效为例关键规则如下匹配文件类型跳转目标alternateartisan项目根php artisan serve/php artisan tinkerapp/*.phpsource源码tests/Unit/{}Test.php、tests/Feature/{}Test.phptests/Feature/*Test.phptest测试app/{}.phptests/Unit/*Test.phptest测试app/{}.phpapp/Models/*.phpmodel—app/Http/Controllers/*.phpcontroller—routes/*.phproute—database/migrations/*.phpmigration—其中{}是占位符会被文件名替换比如app/Models/User.php映射到tests/Unit/UserTest.php反向地tests/Feature/UserTest.php中的{}取User映射回app/User.php。 源码的alternate写成了数组同时指向 Unit 和 Feature 两处点一下会列出候选让你选测试的alternate是单一路径点一下就直达源码。除了 Laravel配置还覆盖了两种通用 PHP 项目结构通过根目录存在composer.json判定src/布局src/*.php↔tests/{}Test.php含 Unit / Feature 子目录候选app/布局app/*.php↔tests/{}Test.php也就是说不需要每个项目单独配置这套 dotfiles 装好后主流 PHP 项目结构都能开箱即跳。gf 一键跳转的关键让不存在的路径也能打开projectionist 计算好路径后还需要gf真正去打开它。默认情况下 vim 的gf遇到不存在的文件会报错而这份 dotfiles 在 nvim/lua/user/keymaps.lua 第 18 行做了一个关键改动vim.keymap.set(, gf, :edit cfileCR, { desc Edit file under cursor })这行把gf重新绑定为:edit cfile——cfile是光标下的文件名而:edit可以创建新文件。于是鼠标点到app/Http/Controllers/UserController.php按gf编辑器列出tests/Unit/UserControllerTest.php和tests/Feature/UserControllerTest.php选中一个测试文件不存在自动新建光标直接落在空文件里等你写代码。这就是一键跳转完整闭环的最后一块拼图。顺手获得的能力gf 还能跑 artisan 命令映射规则里还藏了一个彩蛋artisan文件本身被定义为启动脚本。在artisan文件或项目根上按gf会直接提示运行php artisan serve用c前缀console 模式则可运行php artisan tinker。开发调试循环不用再切终端。快速上手3 步装好这套 dotfiles克隆仓库本仓库就是全部来源git clone https://gitcode.com/gh_mirrors/dotfiles53/dotfiles运行安装脚本 install它会把nvim/软链到~/.config/nvim同时配置 zsh、kitty、tmux、git、phpactor 等sh dotfiles/install启动 Neovim 打开任意 Laravel 项目lazy.nvim会自动拉取tpope/vim-projectionist及其依赖vim-dispatch完成后即可体验gf跳转。插件加载入口在 nvim/lua/user/lazy.lua它扫描user/plugins/目录自动安装所有插件projectionist 的声明就在 nvim/lua/user/plugins/projectionist.lua 第 4 行。总结vim-projectionist用 glob 规则教会 Neovim你的项目长什么样dotfiles 已内置 Laravel 与常见 Composer 布局的源码/测试映射gf重绑定到:edit cfile让跳转支持不存在即创建真正做到一键直达附带收获gf可直接触发php artisan serve/tinker省去终端切换。配置全部集中在nvim/lua/user/plugins/projectionist.lua与nvim/lua/user/keymaps.lua两个文件里规则清晰、注释到位非常适合作为自己的 dotfiles 起点来改造——照着alternate的写法你就能为自己的项目约定加上专属映射。【免费下载链接】dotfiles$HOME sweet $HOME项目地址: https://gitcode.com/gh_mirrors/dotfiles53/dotfiles创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考