React项目代码设端口3000，运行却显示localhost:4001问题咨询

一、React项目端口显示localhost:4001而非设置的3000的原因及解决 #

• 环境变量优先级覆盖：React项目启动时会优先读取环境变量中的PORT值，而非代码配置。检查项目根目录下的.env、.env.development等环境文件，看是否存在PORT=4001的配置；也可以在终端执行echo $PORT，确认系统级环境变量是否被设置为4001。如果有，删除或修改该配置即可。
• 启动脚本参数强制指定：查看package.json中的start脚本，是否在命令中直接指定了端口，比如：

  "scripts": {
    "start": "react-scripts start --port 4001"
  }
  

  或者使用cross-env设置了端口：

  "scripts": {
    "start": "cross-env PORT=4001 react-scripts start"
  }
  

  这种情况下，脚本参数会直接覆盖代码中的端口配置，修改脚本移除端口指定即可。
• 缓存残留影响：极少数情况下，react-scripts的缓存可能保留了旧的端口配置。可以尝试重置缓存启动：

  npm start -- --reset-cache
  

  或者删除node_modules、package-lock.json后重新安装依赖再启动。
• 代理配置间接影响（低概率）：如果项目配置了代理（如setupProxy.js或package.json中的proxy字段指向4001端口的服务），虽然不会改变项目本身的启动端口，但部分开发工具可能误显示代理地址。检查代理配置是否存在，确认后调整或忽略即可（因为项目内容正常展示，不影响使用）。

二、zsh: command not found: lsof 的解决方法 #

• macOS系统：
  • lsof是macOS自带工具，若提示找不到，先尝试使用绝对路径执行：

    /usr/sbin/lsof -i :4001
    

  • 若绝对路径也无效，重新安装Command Line Tools：

    xcode-select --install
    

  • 检查zsh的环境变量配置（~/.zshrc），确保/usr/sbin在PATH中，若没有则添加：

    export PATH="/usr/sbin:$PATH"
    

    执行source ~/.zshrc生效后再试。
• Linux系统：
  • 通过包管理器重新安装lsof：

    # Debian/Ubuntu
    sudo apt update && sudo apt install lsof
    # CentOS/RHEL
    sudo yum install lsof
    

  • 若之前卸载重装无效，可能是权限问题，确保使用sudo执行安装命令。

三、killall后端口仍显示4001的补充处理 #

killall可能未彻底清除相关进程，可通过以下步骤定位并强制终止：

1. 查找与node/react相关的进程：

   ps aux | grep node
   

2. 找到对应进程的PID（第二列数值），强制终止：

   kill -9 [PID]
   

3. 确认进程已结束后，重新启动项目。

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