VSCode中Jenkins-Jack插件“Build”无反应或报401/403，主因是认证或URL配置错误：需正确配置jenkins-jack.url（勿用localhost）、username、password（明文密码非API Token）、crumbUrl（CSRF开启时），并确保job路径大小写及斜杠格式准确。
VSCode 里装了 Jenkins-Jack 插件，但点“Build”没反应、连不上 Jenkins、或者提示 403/401 —— 大概率不是插件坏了，而是认证或 URL 配置错了一处。
jenkins-jack 插件连接失败的常见报错
插件启动后右下角弹出 Failed to connect to Jenkins 或控制台显示 Unauthorized、Forbidden，基本锁定在三类问题：
- Jenkins 实例未启用 CSRF 保护时，插件仍尝试读取
crumb，导致请求被拒（尤其 Jenkins 2.300+ 默认开启） -
jenkins-jack.url配置成http://localhost:8080，但 VSCode 运行在远程开发容器或 WSL 中，localhost 指向的是容器内部而非宿主机 - 账号密码填的是 Jenkins 的「API Token」而非登录密码（Jenkins-Jack 不支持 token 认证，必须用明文密码或已配置好的凭据 ID）
vscode settings.json 中必须配全的四个 key
插件不走 GUI 配置页，所有参数都得手动写进 settings.json。漏掉任意一个，都会静默失败：
-
"jenkins-jack.url"：必须带协议和端口，例如"http://192.168.88.160:8080"（别用 localhost） -
"jenkins-jack.username"：Jenkins 管理员账号名，比如"admin" -
"jenkins-jack.password"：对应账号的**明文密码**（不是 API Token），Jenkins-Jack 不识别 token -
"jenkins-jack.crumbUrl"：仅当 Jenkins 开启 CSRF 时需要，值为"http://192.168.88.160:8080/crumbIssuer/api/xml?xpath=concat(//crumbRequestField,%22:%22,//crumb)"；如果 Jenkins 关了 CSRF（不推荐），此项可删
触发远程构建时 job 名称大小写与斜杠陷阱
插件调用的是 Jenkins 的 /job/{name}/build 接口，而 Jenkins 对 job 名区分大小写，且路径中含文件夹时要用 / 而非 »：
- 若 job 在文件夹
prod/下，真实路径是prod/my-app，那么 VSCode 里右键选择的 job 必须输prod/my-app，不能写prod»my-app或Prod/my-app - 插件不会自动 URL 编码空格或括号，job 名含
My App (staging)时，必须手动改成My%20App%20%28staging%29才能触发成功 - 构建参数（如
BRANCH_NAME=main）需通过插件的jenkins-jack.buildParameters数组传入，不能拼在 URL 里
vscode 插件和 Jenkins Pipeline Linter Connector 冲突吗？
会。两个插件都依赖 Jenkins 的 /pipeline-model-converter/validate 和 /crumbIssuer 接口，但 Jenkins-Jack 会覆盖全局 crumb 缓存逻辑。如果你同时装了 janjoerke.jenkins-pipeline-linter-connector，建议：
- 禁用 Jenkins-Jack 的 lint 功能（设
"jenkins-jack.enableLint": false），只留构建能力 - 或干脆卸载 Jenkins-Jack，改用更轻量的
jenkins-pipeline-linter-connector+ 手动 curl 触发构建（它更稳定，crumb 处理更健壮） - 注意：Jenkins-Jack 的 “Build with Parameters” 功能在 Jenkins 启用代理转发时容易丢参，此时应优先用命令行
curl -X POST "$JENKINS_URL/job/my-job/buildWithParameters" --data "PARAM=value"
真正卡住的点往往不在插件本身，而在 Jenkins 的网络可达性、CSRF 状态、以及 job 路径是否被准确解析 —— 把这三个地方对一遍，90% 的连接失败都能当场解决。
