1. 先别急着怀疑文件不存在这个报错的真实含义No such file or directory是 Linux 里最容易被误读的报错之一。你明明ls能看到脚本cat也能读出内容一执行就甩给你一句bash: ./run.sh: No such file or directory甚至./app这种二进制程序也报同样的错。很多人第一反应是路径写错了反复cd、反复补全路径结果文件就在眼前问题却纹丝不动。这个报错在两种场景下含义完全不同。第一种是真的找不到文件比如路径拼错、工作目录不对、软链接指向了不存在的目标。第二种是文件存在但内核加载器找不到它依赖的解释器或动态链接库。脚本第一行写着#!/bin/bash如果这个解释器路径不存在或者行尾带了 Windows 的\r内核解析 shebang 时就会失败最终统一报成No such file or directory。报错信息骗了你它说的“文件”往往不是你的脚本而是脚本里指定的那个解释器。所以排查思路要分层先确认文件本身在不在、权限够不够再确认文件格式对不对最后确认解释器和依赖是否齐全。这篇就按这个顺序把chmod权限转换、file与ls -l验证、CRLF 格式修复这几步讲透每一步都给可复制的命令和预期输出。适合刚接触 Linux 部署、被这个报错卡住的同学也适合在 CI 流水线里遇到同类问题的同学。顺带说一句如果你在用 AI 编程工具比如 Claude Code、Cursor 这类跑自动化脚本工具本身也会调用 shell 执行命令配置里路径和 Key 写错同样会冒出类似报错。后面我会给一个统一的 Key/API 通道配置骨架帮你把工具侧的变量收敛掉减少这类环境噪音。2. 排查前的准备用 TaoToken 统一 AI 工具的环境变量在动手改权限和格式之前先把一个容易被忽略的干扰源处理掉很多“执行脚本报错”的场景其实是 AI 工具在调用外部命令或 API 时环境变量没配好导致的连锁反应。比如你在settings.json里写了个相对路径的可执行文件工具在非项目根目录启动就会报找不到文件。我的做法是把模型访问通道统一到一个入口环境变量只维护一份脚本和工具都读它。TaoToken 提供统一的 Key 和 API 通道官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。你只需要在控制台生成一个 Key后续所有工具都复用它不用每个工具单独配一套地址和密钥路径类报错能少一大半。具体操作打开控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 创建一个 Key复制保存。这个 Key 就是后面settings.json里要填的值。如果你还没决定用哪个模型可以先去模型对话页 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 试一下调用是否通确认通道没问题再写进配置。注意Key 属于敏感信息不要提交到 Git 仓库建议放在~/.config/下的本地文件或用环境变量注入。这一步不是必须的但它能帮你排除“工具配置错误伪装成文件报错”的情况。环境干净了再去看chmod和文件格式思路会清晰很多。3. 第一层排查chmod 权限转换与 ls -l 验证权限不足时Linux 通常报Permission denied但在某些执行方式下比如通过解释器间接调用、或文件系统挂载参数特殊也可能表现为找不到文件。所以权限是第一道要过的关。先看文件当前权限ls -l run.sh典型输出-rw-r--r-- 1 user user 128 Mar 10 10:00 run.sh这里-rw-r--r--表示所有者可读写、组和其他人只读没有执行位。直接./run.sh会失败。给它加上执行权限chmod ux run.sh再ls -l确认-rwxr--r-- 1 user user 128 Mar 10 10:00 run.sh看到x出现在所有者位就对了。如果你希望组和其他人也能执行chmod x run.sh对应的数字写法是chmod 755 run.sh含义是所有者rwx7、组r-x5、其他r-x5。这里有个常见误区chmod 777虽然能跑但把写权限也开放给了所有人生产环境不要这么干。还有一种情况是文件所在目录没有执行权限。Linux 里目录的x位决定你能否“进入”和访问目录内的文件。如果目录权限是drw-r--r--即使文件本身有x你也进不去ls -ld /opt/scripts chmod x /opt/scripts验证权限是否生效最直接的方式是用test判断test -x run.sh echo 可执行 || echo 不可执行如果权限都对了还是报No such file or directory那基本可以确定问题不在权限而在文件格式或解释器路径。往下走。4. 第二层排查file 与 CRLF 文件格式转换这是最隐蔽的一层。脚本在 Windows 上编辑过行尾是\r\nCRLF而 Linux 只认\nLF。当 shebang 行变成#!/bin/bash\r内核会去找一个名字叫/bin/bash\r的解释器当然找不到于是报No such file or directory。报错指向的是解释器不是你的脚本所以特别容易误导。先用file命令看格式file run.sh如果输出里带CRLFrun.sh: Bourne-Again shell script, ASCII text executable, with CRLF line terminators那就中招了。修复方式有三种按场景选。第一种用sed直接去掉\r适合批量处理sed -i s/\r$// run.sh第二种用dos2unix工具语义最清晰dos2unix run.sh如果系统没装Debian/Ubuntu 系可以apt install dos2unixRHEL 系用yum install dos2unix。第三种用vim手动改适合只想改一个文件、不想装工具的情况vim run.sh进入后输入:set ff回车会显示fileformatdos。改成 unix:set ffunix保存退出:wq改完再用file验证一次CRLF字样应该消失变成ASCII text executable。这时候再执行脚本大概率就通了。顺便说一个容易混淆的点file显示with CRLF不代表文件一定坏有些跨平台项目故意保留 CRLF。但可执行脚本的 shebang 行绝对不能带\r这是硬性要求。所以判断标准不是“有没有 CRLF”而是“shebang 行是否干净”。5. 第三层排查解释器路径与动态链接库如果格式也修了、权限也给了还是报同样的错那要怀疑解释器本身。先看 shebang 指向哪里head -1 run.sh输出比如#!/usr/bin/env python3或者#!/bin/bash然后确认这个解释器真实存在which bash which python3 ls -l /usr/bin/env如果which返回空说明解释器没装或不在 PATH 里。比如脚本写#!/usr/bin/python但系统只有python3就会报找不到文件。解决办法是改 shebang或者建软链接ln -s /usr/bin/python3 /usr/bin/python对于编译型二进制程序报No such file or directory往往是动态链接库缺失。用ldd检查ldd ./app输出里出现not found的行就是缺失的库libssl.so.1.1 not found这种情况需要安装对应库或者用LD_LIBRARY_PATH指定库路径export LD_LIBRARY_PATH/opt/libs:$LD_LIBRARY_PATH ./app还有一个高频坑32 位程序跑在 64 位系统上。file ./app如果显示ELF 32-bit而系统没装 32 位兼容库也会报找不到文件。装libc6:i386之类的兼容包即可。排查到这里基本能覆盖 95% 的No such file or directory。剩下的 5% 可能是文件系统挂载问题比如noexec选项用mount | grep 你的挂载点看有没有noexec有的话重新挂载或换目录。6. 把配置收敛settings.json 骨架与验证请求前面提到 AI 工具侧的配置也会引发类似报错。这里给一个settings.json骨架把模型通道和可执行路径都写成绝对路径避免相对路径带来的“找不到文件”。{ env: { TAOTOKEN_API_KEY: sk-你的Key, TAOTOKEN_BASE_URL: https://taotoken.net/api }, tools: { shell: { executable: /bin/bash, workingDirectory: /home/user/project } }, models: { default: claude-sonnet, provider: { type: openai-compatible, baseURL: https://taotoken.net/api, apiKeyEnv: TAOTOKEN_API_KEY } } }关键点executable写绝对路径/bin/bashworkingDirectory写绝对路径baseURL用统一通道。这样无论工具从哪个目录启动都不会因为相对路径解析失败而报找不到文件。配置好后验证通道是否通用一条 curlcurl -s https://taotoken.net/api/v1/models \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ | head -20返回模型列表 JSON 就说明 Key 和地址都对。如果返回 401检查 Key 是否复制完整返回 404检查baseURL有没有多写或少写/v1。这一步通了再回去跑你的脚本环境层面的干扰就排除了。如果你主要做长期编码或 Agent 类任务可以考虑 Coding Plan把额度集中管理配置一次到处复用https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入细节看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有各工具的完整配置示例。7. 本篇常见错排查清单把上面几层排查浓缩成一张对照表遇到报错按顺序过一遍。现象可能原因验证命令修复ls能看到文件执行报错无执行权限ls -lchmod ux file目录进不去目录无 x 位ls -ld dirchmod x dir报错指向解释器shebang 带\rfile scriptsed -i s/\r$// scriptwhich bash为空解释器未安装which bash安装或改 shebang二进制报错动态库缺失ldd ./app装库或设LD_LIBRARY_PATH32 位程序兼容库缺失file ./app装 i386 兼容包挂载点限制noexec选项mount | grep 挂载点重新挂载几个补充提醒。第一chmod改的是权限sed/dos2unix改的是格式两者不能互相替代报错原因不同要分别处理。第二用vim的:set ffunix时如果文件很大保存可能慢sed更快。第三CI 流水线里建议在构建阶段就加一步file检查把 CRLF 挡在部署之前比线上排查省事得多。我踩过的坑是有一次在 Docker 里跑脚本宿主机是 Windows挂载进去的脚本带了 CRLF容器里报No such file or directory查了半天权限最后file一看才发现是格式问题。从那以后所有跨平台脚本我都会在 CI 里加一行sed -i s/\r$//兜底。8. 继续排查与接入支持权限、格式、解释器这三层走完No such file or directory基本就定位清楚了。如果你在配置 AI 工具时遇到 Key 或地址相关的报错先去 API Keys 页面确认 Key 状态https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 再对照接入文档检查settings.json字段https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。想先验证模型通道是否正常用模型对话页发一条测试消息最快https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。长期做编码和 Agent 任务的话Coding Plan 能把额度统一起来省得每个工具单独配https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。