需安装Perl运行时、cpanm及Perl::LanguageServer等模块，配置VSCode的Perl扩展、语言服务器路径、调试器launch.json和Perl::Tidy格式化功能。
如果您希望在 Visual Studio Code 中高效编写和调试 Perl 脚本，但发现默认环境缺乏语法高亮、智能补全或断点调试支持，则可能是由于未正确配置 Perl 相关扩展与运行时工具链。以下是为 VSCode 设置 Perl 开发环境的具体步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 Perl 运行时与核心工具
VSCode 本身不包含 Perl 解释器，需先确保系统级 Perl 环境可用，并安装用于代码分析的辅助工具。这些工具是后续扩展功能正常工作的基础依赖。
1、打开终端，执行 brew install perl 安装最新稳定版 Perl（若已使用 perlbrew 或 plenv，请跳过此步并确保 perl -v 可返回有效版本号）。
2、运行 cpan App::cpanminus 安装 cpanm，用于快速获取 Perl 模块。
3、执行 cpanm Perl::LanguageServer PPI Perl::Tidy 安装语言服务器及代码格式化支持模块。
二、启用 Perl 语言支持扩展
VSCode 需通过扩展识别 .pl 和 .pm 文件的语法结构，并提供基础高亮与括号匹配。该扩展不依赖外部服务，可独立启用。
1、在 VSCode 中按下 Cmd+Shift+X 打开扩展面板。
2、搜索关键词 Perl，找到作者为 dfreeman 的扩展，名称为 Perl（图标为绿色圆角矩形内含白色“P”）。
3、点击“Install”，安装完成后重启 VSCode。
三、配置 Perl 语言服务器
Perl::LanguageServer 提供符号跳转、悬停提示、重命名等 LSP 功能，需在 VSCode 设置中显式指定其启动路径与 Perl 解释器位置。
1、按下 Cmd+, 打开设置界面，切换至“JSON”编辑模式（点击右上角 `{}` 图标）。
2、在 settings.json 中添加以下键值对：
"perl.perlInc": ["/usr/local/lib/perl5/site_perl"],
"perl.executable": "/opt/homebrew/bin/perl",
"perl.languageServerPath": "/opt/homebrew/bin/perl-language-server"
3、确认路径与本地实际安装位置一致：可通过终端运行 which perl 和 which perl-language-server 验证。
四、设置调试器 launch.json
VSCode 内置的 Node.js 或 Python 调试器不兼容 Perl，必须借助第三方调试适配器。此处采用 vscode-perl-debug 扩展提供的调试支持。
1、在扩展市场中安装 vscode-perl-debug（作者：rchl）。
2、在项目根目录下创建 .vscode/launch.json 文件，内容如下：
{ "version": "0.2.0", "configurations": [ { "type": "perl", "request": "launch", "name": "Perl Launch", "program": "${file}", "stopOnEntry": false } ] }
3、打开任意 .pl 文件，按 Cmd+Shift+D 切换到运行视图，点击绿色三角形启动调试。
五、启用代码格式化与保存自动修正
通过集成 Perl::Tidy，可在保存时自动调整缩进、空格与换行，统一团队代码风格，避免手动整理耗时。
1、在设置 JSON 中追加以下配置项：
"perl.tidyOnSave": true,
"perl.tidyPath": "/opt/homebrew/bin/perltidy"
2、创建项目级配置文件 .perltidyrc 放置于工作区根目录，写入自定义规则，例如：
-noll -pt=2 -sbt=2 -bbt=2 -cti=2
3、编辑 Perl 文件后按 Cmd+S 保存，观察代码结构是否按预设规则重排。
